Conhecendo o Studio
O Agent Studio é onde você monta, testa e ativa agentes. Ele fica dentro do Imaginne, em ai.nnumbers.com.br/agent, e usa a mesma sessão: não há login separado.
Três formas de montar o mesmo agente
| Forma | Como se parece | Quando usar |
|---|---|---|
| Conversa | Você descreve, o Imaginne monta | Começar do zero, alterar sem procurar onde fica, entender uma falha |
| Modo simples | Uma lista numerada de etapas, ligadas automaticamente | A maioria dos agentes: uma etapa depois da outra |
| Editor visual | Um quadro com caixas e ligações | Quando o fluxo tem caminhos paralelos, desvios ou junções |
As três agem sobre o mesmo documento. O que nasce da conversa aparece na lista e no canvas na hora; o que você move com o mouse é o que a conversa enxerga na frase seguinte. Ver Construir conversando.
O modo simples é o padrão para edição manual. Quando um fluxo passa a ter ramos paralelos, ele se recusa a mostrá-lo como lista e leva você ao editor visual — sem alterar nada. Uma lista que escondesse um ramo mostraria um fluxo que não é o que roda.
Encontrar as coisas
| Recurso | Como chegar |
|---|---|
| Paleta de comandos | Cmd/Ctrl + K — vai para qualquer agente, espaço ou ação sem navegar |
| Explorar | a galeria de exemplos prontos, por categoria, com um botão que cria de verdade |
| Favoritos | marque um agente e ele fica à mão; a marcação é sua e acompanha o seu usuário |
| Início | as portas de entrada, os agentes recentes e o pulso da organização |
A biblioteca de componentes
Ao acrescentar uma etapa, você escolhe de uma biblioteca com busca — que encontra por sinônimo e ignora acento —, com sugestões e com os que você usou por último.
Você não digita o nome técnico de uma ferramenta em lugar nenhum. Ver Componentes de sistema.
Partir de algo que já existe
| Caminho | O que faz |
|---|---|
| Importar cURL | cole um curl e a etapa HTTP nasce configurada; credencial no comando vira secret ou fica de fora |
| Importar OpenAPI | aponte para um documento 3.x, escolha a operação e a etapa nasce montada |
| Capturar do webhook | dispare uma chamada real e o formato capturado vira o esquema de entrada |
| Salvar como template | transforme um agente pronto em modelo, seu ou da organização, marcando o que vira pergunta |
O ciclo de trabalho
Salvar → Testar → Ativar
| Ação | O que faz |
|---|---|
| Salvar | Grava o rascunho. Não afeta nada que esteja rodando |
| Testar | Executa de verdade, com dados que você informa |
| Ativar | Publica uma versão imutável e a coloca ativa em um ambiente |
Testar é execução real. Não é simulação: cria uma execução durável, com linha do tempo, e passa pelas mesmas permissões de qualquer outra. É por isso que ela serve para decidir se pode ativar.
O painel de etapa
Clicar em uma etapa abre o painel de configuração à direita. Ele é organizado em blocos fixos:
| Bloco | Conteúdo |
|---|---|
| Configuração | O essencial daquela etapa |
| Dados de entrada | O que ela recebe das etapas anteriores |
| Saída esperada | O que ela deve devolver |
| Em caso de falha | O que acontece quando ela não funciona |
| Avançado | Tempo limite, tentativas e ajustes finos |
O painel pode ser redimensionado e aberto em tela cheia, e a largura escolhida é lembrada.
O resumo da etapa
Cada etapa mostra, em uma linha, o que recebe · o que faz · o que produz. É o que permite ler um fluxo de dez etapas sem abrir dez painéis.
O botão "Dado"
Você nunca digita o caminho técnico de um dado. Onde um campo aceita informação de outra etapa, o botão Dado abre o seletor com o que está disponível naquele ponto do fluxo — e apenas isso.
Dentro de um laço, "o item" e "a posição" aparecem no seletor; fora dele, não aparecem, porque ali não existem.
Um teste de etapa bem-sucedido fixa o resultado sozinho, e a partir daí o seletor passa a oferecer os campos reais daquela resposta — inclusive os aninhados, como body.cliente.endereco.cidade. Renomear uma etapa não quebra as referências: elas apontam para um identificador estável, não para o nome.
Ver Dados entre etapas.
Recursos disponíveis
Ferramentas, skills e conexões aparecem com o estado real de cada uma:
| Estado | Significa |
|---|---|
| Disponível | Pode ser usada agora |
| Não liberada | Existe, e o espaço ainda não a liberou |
| Indisponível | Não existe nesta instalação |
| Não confirmado | Não foi possível verificar agora |
"Não confirmado" nunca vira "não existe": as duas levariam a decisões opostas. Há um botão para verificar de novo.
Ver Recursos liberados.
A barra de estado
No topo do editor, o Studio mostra em que pé o agente está: se há rascunho não publicado, qual versão está ativa em cada ambiente e o que falta para ativar. É de lá que saem os avisos do tipo "esta alteração ainda não foi publicada".
O tema acompanha o seu
Claro ou escuro, a escolha é sua e é a mesma do WebChat: trocar em um vale no outro.
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.