Agentes Personalizados
Os Agentes Personalizados permitem criar e gerenciar seus próprios agentes do Smart Engineering. Um agente tem um prompt de sistema, uma configuração de modelo, um conjunto de ferramentas e recursos, opcionalmente habilidades, receitas e pacotes de referência fixados, e limites como o número máximo de rodadas de raciocínio. Agentes publicados ficam disponíveis no Chat Agêntico.
Abra o catálogo de agentes em Agêntico → Chat → Personalizar → Agentes.
Quando usar
- Criar um assistente especializado para uma tarefa recorrente, como revisar um tipo específico de código legado.
- Dar a um agente um modelo, um conjunto de ferramentas e um contexto de referência fixos para resultados consistentes.
- Empacotar conhecimento (habilidades e receitas) atrás de um único agente com o qual a equipe pode conversar.
Ciclo de vida do agente
| Status | Significado |
|---|---|
| Rascunho | Editável. Não é oferecido a novas conversas. |
| Ativo | Publicado e selecionável no Chat Agêntico. |
| Descontinuado | Oculto de novas conversas. Pode voltar para rascunho. |
No catálogo você pode criar, editar, duplicar, descontinuar, restaurar, conversar com, executar em segundo plano ou excluir permanentemente um agente (a exclusão também remove suas execuções).
Criar um agente
- Abra Personalizar → Agentes e selecione Novo agente, ou Criar com IA para gerar um rascunho a partir de uma descrição.
- Defina o nome (um slug é derivado dele), a descrição e a versão.
- Escreva o prompt de sistema e o modelo de prompt do usuário.
- Escolha o provedor e o modelo de LLM, a temperatura e o máximo de tokens de saída.
- Revise as ferramentas e os conjuntos de recursos. Novos agentes começam com todas as ferramentas e recursos habilitados; restrinja-os com Personalizar ferramentas quando o agente precisar ser limitado.
- Opcionalmente, fixe habilidades, receitas e pacotes de referência que o agente deve ter sempre disponíveis.
- Defina os limites de execução: máximo de rodadas, máximo de chamadas de ferramenta por rodada e um tempo limite.
- Defina os artefatos de saída que o agente deve produzir, se houver.
- Defina a visibilidade (privada ou da organização) e salve. O agente é criado como rascunho.
Executar um agente
- Chat: abra uma conversa com o agente no Chat Agêntico.
- Executar em segundo plano: inicie uma execução com uma única entrada e revise-a depois.
Execuções
Personalizar → Execuções de agentes lista as execuções em segundo plano com seu status (criada, em execução, concluída, com falha, cancelada). Abra uma execução para revisar as rodadas, as chamadas de ferramenta, o uso de tokens, a resposta final e quaisquer artefatos gerados. Você pode cancelar uma execução em andamento ou excluir uma já finalizada.
Resultado esperado
Um agente publicado que aparece no Chat Agêntico com o prompt, o modelo, as ferramentas e o contexto de referência que você configurou, além de um registro de cada execução em segundo plano.