Módulos
Agentes
Modelo base, instruções e parâmetros, publicados para os workspaces e as pessoas escolhidos.
Nesta página
Um agente é um pacote governado de modelo, instruções e parâmetros, publicado apenas para os workspaces e as pessoas escolhidos. Ele padroniza o comportamento do modelo no chat e nos fluxos, de forma revisável e auditável.
Anatomia de um agente
| Campo | Descrição |
|---|---|
| Nome e descrição | Como o agente aparece no chat. |
| Modelo base | Um modelo local ou de provedor externo, habilitado em cada workspace em que o agente será publicado. |
| Instruções | O prompt de sistema: papel, tom, formato de resposta e limites. |
| Parâmetros de geração | Temperatura, máximo de tokens, penalidade de repetição, top-p e top-k. |
| Status | Rascunho, publicado ou arquivado. |
| Acesso | Workspaces e pessoas que podem usar o agente. |
Conhecimento e ações
O agente não carrega contexto de conhecimento próprio nem ferramentas. O conhecimento vem de duas formas:
- No chat: do contexto de conhecimento ou de dados que a pessoa seleciona na conversa.
- Em um fluxo: de blocos como Busca no armazenamento e Consulta de dados, posicionados antes do bloco de agente.
Para que um agente aja sobre outros sistemas, coloque-o em um fluxo com blocos de Integração ou de Gravar dados.
Planejado: uso de ferramentas por agentes e conexão com servidores MCP (Model Context Protocol). Esses recursos não fazem parte da versão 3.7.
Criar e publicar
- Em Agentes, crie o agente e escolha o modelo base.
- Escreva as instruções. Seja explícito sobre o que o agente deve e não deve fazer.
- Ajuste os parâmetros de geração, se necessário.
- Selecione os workspaces e as pessoas com acesso.
- Publique. Agentes em rascunho ou arquivados não aparecem no chat.
A criação e a publicação de agentes são feitas por administradores.
Uso no chat e nos fluxos
Um agente publicado aparece como alvo de conversa no Chat para quem tem acesso a ele. Nos fluxos, o bloco agente envia o contexto do passo anterior ao agente e entrega a resposta às etapas seguintes.
Cada chamada de modelo feita por um agente entra no registro unificado, com modelo, workspace, pessoa, tokens e avaliação.
Boas práticas
- Um agente por tarefa: agentes focados são mais fáceis de revisar e auditar.
- Instruções explícitas sobre formato, limites e o que fazer quando faltar informação.
- Para respostas fundamentadas em documentos, combine os blocos Busca no armazenamento e Agente em um fluxo.
- Prefira modelos locais quando o conteúdo não puder sair do ambiente da organização.