Agentes

Agentes são assistentes de IA configurados para executar tarefas específicas. No AI Cockpit Lens, cada agente atua como uma unidade de processamento com seu próprio prompt de sistema, provedor e modelo de IA, template de mensagem do usuário, variáveis de contexto, ferramentas e bases de conhecimento vinculadas. Agentes podem apoiar raciocínio, código, chat, documentação, testes, análise de requisitos, revisão de arquitetura e workflows personalizados.

Quando usar

• Use agentes para criar assistentes com um objetivo claro.
• Use a lista de agentes para revisar assistentes existentes e abrir seus detalhes.
• Use o playground para testar um agente antes de adicioná-lo a workflows importantes.
• Use agentes como blocos reutilizáveis que compõem etapas de workflow.

Antes de começar

• Confirme a organização ativa.
• Defina o propósito do agente antes de criá-lo.
• Prepare as instruções que devem orientar o comportamento do agente.
• Confirme quais opções de modelo de IA estão disponíveis para a organização.
• Prepare variáveis de contexto, ferramentas ou bases de conhecimento que o agente deve usar.

Passo a passo: navegar por agentes

1. Clique em Agentes na navegação principal.
2. Use a busca para filtrar por nome ou descrição.
3. Ordene por nome ou data quando necessário.
4. Abra um agente para revisar seus detalhes.

Passo a passo: criar um agente

1. Clique em Criar Agente.
2. Preencha as informações básicas: nome, tipo e descrição.
3. Escolha o provedor e o modelo de IA disponíveis para sua organização.
4. Informe o prompt de sistema que define como o agente deve se comportar.
5. Adicione o template de mensagem do usuário quando o agente precisar de um formato estruturado de entrada.
6. Configure variáveis de contexto, ferramentas e bases de conhecimento vinculadas quando disponíveis.
7. Ajuste configurações como timeout, tentativas de retry e streaming quando disponíveis.
8. Clique em Salvar Agente.

Entenda os principais campos

Campo	O que significa
Nome	Nome exibido em listas e detalhes.
Tipo	Categoria que descreve o propósito do agente.
Descrição	Explicação curta sobre o que o agente faz.
Provedor e modelo	Serviço e modelo de IA usados pelo agente.
Prompt de sistema	Instrução principal que orienta o comportamento do agente.
Template de mensagem do usuário	Estrutura usada para montar a solicitação enviada ao agente.
Variáveis de contexto	Valores dinâmicos incluídos quando o agente recebe uma solicitação.
Ferramentas	Capacidades externas que o agente pode chamar quando habilitadas.
Bases de conhecimento	Fontes RAG que o agente pode consultar para contexto da organização ou do projeto.
Timeout	Tempo máximo esperado de resposta.
Streaming	Permite que a resposta apareça progressivamente quando houver suporte.

Passo a passo: testar no playground

1. Abra os detalhes de um agente ativo.
2. Clique em Abrir Playground.
3. Digite uma mensagem no campo de entrada.
4. Clique em Executar Agente.
5. Aguarde a resposta.
6. Revise status, uso, custo e duração quando esses detalhes forem exibidos.

Passo a passo: editar ou excluir um agente

1. Abra os detalhes do agente ou use a ação da lista.
2. Clique em Editar para alterar a configuração.
3. Para remover o agente, escolha Excluir e confirme a ação.

cuidado

Excluir um agente pode afetar workflows que dependem dele.

Resultado esperado

Você deve ter um agente com nome claro, configurado com as instruções corretas e testado antes de ser reutilizado em workflows.

Dicas e problemas comuns

• Se a saída do agente não está alinhada à tarefa, revise o prompt de sistema e o template de mensagem do usuário.
• Se a execução falhar, verifique se o provedor e o modelo selecionados estão disponíveis para a organização.
• Se o agente é usado por workflows, revise esses workflows antes de editar configurações críticas.