Agentes

Preferências do agente

Todas as configurações do painel do construtor de agentes: detalhes, modelo, instruções, gatilhos, limites de geração, saída estruturada e o bloco de boas-vindas.

O painel de configurações à direita do construtor de agentes tem três abas: Preferências, Avançado e Histórico. Esta página aborda as duas primeiras. A memória e o histórico de conversas estão em sua própria página, as ferramentas em outra e o Histórico em compartilhar e publicar.

Cada seção é uma faixa recolhível com seu próprio ícone e um resumo de uma linha do seu valor atual. As alterações são salvas como rascunho cerca de um segundo depois que você para de digitar. Use os botões de desfazer e refazer na barra superior, ou Ctrl+Z e Ctrl+Shift+Z (⌘ no Mac), para percorrer suas edições. O histórico de desfazer dura enquanto a página do construtor estiver aberta.

Aba Preferências#

Detalhes#

Esta seção fica recolhida quando você abre o construtor. Ela guarda os fatos sobre o agente, e não como ele responde.

  • Nome. Até 100 caracteres. O nome é salvo quando você pressiona Enter ou sai do campo.
  • Descrição. Exibida na lista de Agentes, no cartão da biblioteca e na tela de boas-vindas do chat.
  • Categoria. A categoria na qual o agente está arquivado.
  • Placeholder de entrada do chat. O texto cinza na caixa de chat vazia.
  • Desativar entrada de texto. Desliga a caixa de texto do chat.
  • Descrição detalhada. Um texto mais longo, escrito em Markdown.

Modelo e instruções#

  • Modelo. O modelo de linguagem com o qual o agente pensa. A opção padrão seleciona o modelo que seu workspace marcou como padrão.
  • Esforço de raciocínio. Aparece apenas para modelos que o suportam. Os valores disponíveis dependem do modelo. O padrão é nenhum.
  • Deep agent. Um interruptor. Ele dá ao agente um sistema de arquivos, uma ferramenta de planejamento e um subagente auxiliar ao qual ele pode delegar trabalho. Use-o para tarefas longas e com várias etapas; um agente simples responde mais rápido.
  • Mensagem do sistema. As instruções. Diga quem é o agente, o que ele pode fazer e como deve responder. O padrão é “Você é um assistente prestativo.”
  • Mostrar progresso. Mostra o progresso do agente e as chamadas de ferramentas no chat enquanto ele trabalha. Vem ativado por padrão.

Se você mudar para um modelo que não aceita o esforço de raciocínio escolhido, o construtor o redefine para nenhum, ou para o primeiro valor permitido do modelo.

Apps#

As ferramentas que o agente pode chamar. Consulte ferramentas do agente.

Gatilhos#

Chat está sempre ativado: ele cobre o chat de teste, os chatbots e a API. Clique em Adicionar gatilho para permitir que outra coisa inicie o agente, como uma mensagem do Slack, uma agenda ou um webhook. Cada gatilho tem um selo de status:

  • Ativo: o gatilho está em funcionamento.
  • Publicar para ativar: o rascunho tem um gatilho que a versão publicada não tem. Webhooks e agendas são registrados quando você publica.
  • Conectar: o gatilho precisa de uma conta que você não conectou. Clique nele para conectar. Consulte conectar contas.

A engrenagem abre as configurações do gatilho. O menu de três pontos o remove. Os gatilhos disponíveis estão listados na referência de etapas.

Aba Avançado#

Geração#

  • Temperatura. Valores mais altos tornam as respostas mais aleatórias, valores mais baixos mais determinísticas. O padrão é 0,7 e o intervalo é de 0 a 2, mas alguns modelos limitam a um valor menor (os modelos da Anthropic param em 1). Ela fica oculta para modelos de raciocínio, que a ignoram.
  • Máximo de tokens de saída. A resposta única mais longa. O padrão é 3000.
  • Máximo de iterações. Quantas rodadas de raciocínio e chamadas de ferramentas o agente pode executar. O padrão é 20 e o máximo é 250.

Saída estruturada#

Ative-a para fazer o agente responder em JSON, em um formato que você define. Em Esquema de saída você lista cada campo de saída com um nome, um tipo (string, int, float, bool, list ou dict) e uma descrição.

Quando o chat abre#

Blocos que o chat exibe antes da primeira pergunta, como uma mensagem de boas-vindas, botões ou cartões. Clique em Adicionar bloco e escolha um da lista. Arraste os blocos para reordená-los e remova um deles pela sua linha. Abra um bloco para editar seu conteúdo. Sem blocos, o chat abre vazio.

Histórico de conversas#

Consulte memória e histórico de conversas.

A aba Avançado acompanha a etapa

A aba Avançado é construída a partir da própria definição da etapa AI Agent. Se a etapa ganhar uma configuração, ela aparece aqui sem nenhuma alteração nesta página. A referência do AI Agent lista todas elas.

Se algo der errado#

Se você não conseguir editar nada, talvez tenha aberto o agente no modo Ver como usuário ou seu papel pode não ter direitos de edição. Clique no botão de lápis Editar agente na barra superior. Se o painel mostrar que os nós do fluxo não correspondem mais ao formulário do agente, consulte converter em fluxo de trabalho.