Início rápido
Nesta página você cria um agente a partir de um modelo pronto, testa e ativa.
Antes de começar
- Acesso ao Imaginne e ao Agent Studio, em
ai.nnumbers.com.br/agent. - Perfil que permita construir no espaço em que você vai trabalhar. Ver Espaços e acesso.
- Uma conta de execução configurada na organização — é ela que executa etapas com IA. Se não houver, o Studio avisa. Ver Conta de execução.
Passo a passo
1. Escolha um modelo pronto
Em Novo agente, abra a galeria. Cada modelo mostra o que faz, o caso de uso, quanto tempo leva para configurar e o que ele exige — e só aparece como pronto para usar quando tudo o que ele precisa está liberado no seu espaço.
Para o primeiro, Resumir um texto é o caminho mais curto: exige apenas a conta de execução.
2. Ajuste o que for seu
O modelo abre já montado. O que costuma mudar:
- o objetivo da tarefa com IA — o que você pediria a uma pessoa;
- os campos de entrada — o que o agente recebe quando é acionado;
- os campos do resultado — o que ele devolve.
3. Salve
Salvar grava o rascunho. Rascunho não roda em produção — ele existe para você trabalhar.
4. Teste
Testar executa o agente de verdade, com dados que você informa. É uma execução real, durável e visível na linha do tempo — não uma simulação.
Você também pode testar uma etapa isolada, sem montar o fluxo inteiro. Ver Testar antes de publicar.
5. Ative
Ativar publica uma versão e a coloca ativa em development. A partir daí o agente pode ser acionado.
A versão publicada é imutável: continuar editando cria um novo rascunho, e a versão ativa segue exatamente como foi testada.
6. Acompanhe
Cada acionamento cria uma execução, com linha do tempo etapa a etapa, entrada, saída e o motivo de qualquer falha. Ver Acompanhar execuções.
O que acontece depois
- Para colocar em produção, é preciso promover a mesma versão — e isso exige perfil de publicação e evidência de que ela rodou com sucesso em
development. Ver Promover e voltar versão. - Para rodar sozinho, adicione um acionador: agendamento, endereço HTTP ou chamada de outro agente.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O modelo aparece como "precisa de configuração" | Algo que ele exige não está liberado no espaço | A tela lista o que falta; ver Recursos liberados |
| "É preciso uma conta de execução" | A organização não tem conta de execução ativa | Ver Conta de execução |
| A publicação é recusada | A definição tem um problema estrutural | A mensagem aponta a etapa; ver Erros de execução |
| A etapa com IA falha sem explicação clara | Falta declarar o que ela deve devolver | Ver Tarefa com IA |
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.