1. Melhores Práticas para Implementação e Orquestração
A implantação bem-sucedida de agentes na plataforma EKB requer planejamento estratégico e aderência às melhores práticas de orquestração.Planejamento Estratégico
Identificando Casos de Uso de Alto Valor
Aproveite as capacidades da plataforma focando nos setores onde os agentes EKB se destacam:- Finanças: Agentes de consulta SQL para relatórios de P&L e análise de risco.
- RH: Agentes de triagem de currículos que analisam PDFs e elaboram e-mails.
- Desenvolvimento de Software: Agentes de revisão de PR para análise de código e documentação.
- Vendas: Agentes de enriquecimento de leads integrando Busca Web e Salesforce.
- Suporte ao Cliente: Agentes de suporte de nível 1 com acesso a ERP e Base de Conhecimento.
Definindo o Escopo do Agente
| Escopo | Descrição | Configuração EKB |
|---|---|---|
| Propósito Único | Lida com fluxo de trabalho específico (ex.: Redefinição de Senha) | Prompt de Personalidade Focado, Toolkit Único |
| Departamental | Cobre tarefas da equipe (ex.: RH Geralista) | Múltiplas Coleções de Conhecimento, Workflow Manager |
| Assistente Empresarial | Delega a agentes especializados | Utiliza o Agent Communication Toolkit para delegação multi-agente |
Padrões de Design de Agentes
Padrão 1: Especialista Único Um agente dedicado equipado com conhecimento profundo de domínio e ferramentas específicas. Por exemplo, um agente “Analista de Dados” configurado com o Database Toolkit e o Python Code Execution Toolkit. Padrão 2: Sistemas Multi-Agente Use o Agent Communication Toolkit para criar um sistema onde um “Agente Gerente” decompõe solicitações complexas e delega tarefas a “Agentes Trabalhadores” especializados. Isso garante separação de responsabilidades e maior precisão para fluxos de trabalho complexos.Estratégia de Base de Conhecimento
O Knowledge Base Toolkit alimenta o Retrieval Augmented Generation (RAG). Para otimizar o desempenho:- Chunking: A plataforma trata o chunking, mas garantir uma estrutura clara do documento melhora a recuperação.
- Versionamento: Remova documentos desatualizados para evitar respostas conflitantes.
Engenharia de Prompts (Prompts de Personalidade)
O Prompt de Personalidade (também chamado de Instrução de Sistema) na aba de Configurações Gerais é a alavanca de configuração mais poderada disponível na plataforma EKB. Este campo de texto único governa a identidade, comportamento, estrutura de tomada de decisão e estilo de interação do seu agente. Ao contrário do que o nome sugere, ele deve conter instruções abrangentes — não apenas traços de personalidade.Por que os Prompts de Personalidade São Importantes
Um Prompt de Personalidade bem elaborado faz a diferença entre um chatbot não confiável e um assistente empresarial de confiança. Ele:- ✅ Define o domínio de expertise e o escopo de responsabilidade do agente
- ✅ Estabelece limites comportamentais para prevenir alucinações ou respostas inadequadas
- ✅ Instrui o agente sobre quando e como usar ferramentas (Banco de Dados, Busca Web, etc.)
- ✅ Especifica a formatação da resposta para consistência entre conversas
- ✅ Define gatilhos de escalação para cenários que requerem intervenção humana
Anatomia de um Prompt de Personalidade Robusto
Estruture seu Prompt de Personalidade com esses componentes essenciais:| Componente | Finalidade | Exemplo |
|---|---|---|
| 1. Definição de Função | Estabelece expertise e autoridade | ”Você é um Desenvolvedor Sênior de Python especialista com 10 anos de experiência em sistemas back-end e design de API.” |
| 2. Missão Principal | Define a tarefa/objetivo central | ”Sua responsabilidade principal é revisar trechos de código submetidos por desenvolvedores juniores e sugerir otimizações de desempenho, melhorias de segurança e melhores práticas.” |
| 3. Contexto do Usuário | Descreve a quem o agente atende | ”Seus usuários são engenheiros juniores (1-3 anos de experiência) aprendendo Python. Presuma que eles entendem a sintaxe básica, mas podem precisar de orientação em padrões avançados.” |
| 4. Restrições Comportamentais | Estabelece limites e proteções | ”NÃO escreva código do zero. Apenas revise o código submetido. Se uma solicitação não estiver relacionada ao desenvolvimento Python, recuse educadamente e sugira contatar a equipe apropriada.” |
| 5. Regras de Uso de Ferramentas | Instrui quando/como usar toolkits | ”Sempre use o Python Code Execution Toolkit para verificar suas sugestões antes de responder. Se não puder testar o código, declare explicitamente: ‘Esta recomendação não foi testada.‘“ |
| 6. Formato de Saída | Garante estrutura de resposta consistente | ”Formate todas as respostas usando Markdown com: 1) Resumo do problema, 2) Recomendações específicas em tópicos, 3) Exemplo de código em blocos de código, 4) Explicação de por que a melhoria melhora desempenho/segurança.” |
| 7. Gatilhos de Escalação | Define quando envolver humanos | ”Se o código envolver migrações de banco de dados, cálculos financeiros ou autenticação de segurança, responda: ‘Isto requer revisão de engenharia sênior. Por favor, escale para a equipe de Arquitetura.‘“ |
| 8. Tom e Estilo | Estabelece a abordagem de comunicação | ”Seja encorajador e educativo. Evite linguagem condescendente. Celebre boas práticas quando as perceber. Mantenha as respostas com menos de 200 palavras, a menos que uma explicação técnica aprofundada seja necessária.” |
Exemplo Completo de Prompt de Personalidade: Agente de Suporte de TI
Melhor Prática: Refinamento Iterativo
Nenhum Prompt de Personalidade é perfeito no Dia 1. Após a implantação:- Revise os logs de conversa na interface de Chat
- Identifique onde o agente falhou ou forneceu respostas incorretas
- Atualize o Prompt de Personalidade para abordar esses cenários específicos
- Use o Histórico de Versões para rastrear alterações e reverter se necessário
- Repita mensalmente para melhoria contínua
Técnicas Avançadas de Engenharia de Prompts
Exemplos Few-Shot (Aprendizado no Contexto)
Inclua 2-3 exemplos de interação diretamente no seu Prompt de Personalidade para demonstrar o comportamento desejado:Restrições Negativas (O Que NÃO Fazer)
Liste explicitamente comportamentos proibidos para reduzir alucinações e erros:- ❌ “Nunca invente informações de funcionários se um usuário não for encontrado. Diga: ‘Não consigo localizar esse ID de Funcionário. Por favor, verifique e tente novamente.’”
- ❌ “Nunca forneça instruções de redefinição de senha para contas que não puder verificar.”
- ❌ “Nunca suponha permissões. Em caso de dúvida, escale.”
Raciocínio Chain-of-Thought
Instrua o agente a explicar seu processo de raciocínio para transparência:Lógica Condicional para Tratamento Multi-Cenário
Use estruturas IF-THEN para lidar com diferentes tipos de solicitação:Testando Seu Prompt de Personalidade
Use a interface de Chat para testar estes cenários antes da implantação:| Cenário de Teste | Comportamento Esperado | Valida |
|---|---|---|
| Caminho Feliz | Fornece todas as informações necessárias; o agente conclui a tarefa com sucesso | Funcionalidade central funciona |
| Informação Ausente | O agente faz perguntas de esclarecimento em vez de presumir | Lógica de coleta de informações |
| Solicitação Fora do Escopo | O agente recusa educadamente e explica o motivo | Aplicação de limites |
| Consulta Ambígua | O agente pede esclarecimento antes de agir | Proteções de segurança |
| Falha de Ferramenta | O agente explica o problema e sugere alternativas | Tratamento de erros |
| Gatilho de Escalação | O agente identifica corretamente a necessidade de intervenção humana | Lógica de escalação |
Orquestração de Ferramentas e Toolkits
Selecione os Toolkits EKB apropriados para estender as capacidades do agente:- Knowledge Base Toolkit: Recuperação baseada em RAG a partir de documentos proprietários.
- Web Search Toolkit: Acesso a informações em tempo real.
- Database Toolkit: Consulta a bancos de dados SQL e Smart Tables.
- Toolkits Python/Node.js: Sandboxes seguros de execução de código.
- Document Manager Toolkit: Crie e edite documentos no chat.
- Smart Table Manager Toolkit: Gerenciamento interno de dados estilo NoSQL.
- Agent Communication Toolkit: Delegue tarefas a outros agentes.
- Workflow Manager Toolkit: Execute fluxos de trabalho de automação determinísticos.
- Image Generation Toolkit: Crie imagens usando DALL-E 3.
Fluxo de Trabalho de Testes e Iteração
Use o Chat/Canvas do Painel Central para testes iterativos. Lista de Verificação de Cenários de Teste- Caminho Feliz: Consulta padrão com todo o contexto.
- Informação Ausente: O agente faz perguntas de esclarecimento?
- Gatilhos de Ferramentas: Verifique se toolkits específicos são ativados corretamente.
- Casos Extremos: Solicitações ambíguas ou fora do escopo.
- Latência: Verifique o desempenho em cadeias de ferramentas complexas.
Governança e Conformidade
Adira às melhores práticas de segurança da EKB:- Princípio do Menor Privilégio: Conceda aos agentes apenas as ferramentas mínimas necessárias.
- Humano no Loop: Configure fluxos de trabalho de aprovação para ações de alto risco (ex.: e-mails em massa, gravações em BD).
- Controles de Acesso a Dados: Use acesso baseado em funções e mascaramento de PII.
- Logging de Auditoria: Habilite logging para todas as ações para conformidade.
- Proteção contra Injeção de Prompts: Valide entradas para evitar substituições maliciosas.
O Que Vai no Prompt de Personalidade?
Todo agente de produção deve ter estes elementos claramente definidos:- Função & Expertise: Quem é este agente? Que conhecimento de domínio possui?
- Declaração de Missão: Qual é o objetivo principal do agente? Que problemas resolve?
- Público-Alvo: Quem interagirá com este agente? Qual é seu nível técnico?
- Escopo & Limites: Em QUEM o agente PODE ajudar? O que está explicitamente FORA DO ESCOPO?
- Regras Comportamentais: Comportamentos obrigatórios e proibidos
- Diretrizes de Uso de Ferramentas: Quando e como usar Banco de Dados, Busca Web, Python, etc.
- Estrutura de Resposta: Como as respostas devem ser formatadas?
- Critérios de Escalação: Quando delegar a um humano ou agente especializado
- Tom e Estilo: Formal? Amigável? Técnico? Empático?
Exemplo do Mundo Real: Agente de Enriquecimento de Leads de Vendas
O Que Fazer e O Que Não Fazer no Prompt de Personalidade
| ✅ FAÇA | ❌ NÃO FAÇA |
|---|---|
| Seja explícito sobre o que o agente PODE e NÃO PODE fazer | Presuma que o agente vai “descobrir sozinho” |
| Inclua 2-3 exemplos concretos do comportamento desejado | Use instruções vagas como “seja útil” |
| Especifique padrões exatos de uso de ferramentas | Dependa do agente para saber quando usar ferramentas |
| Defina o formato da resposta com seções numeradas | Permita que o agente escolha sua própria estrutura de saída |
| Defina diretrizes de contagem de palavras ou comprimento | Aceite respostas verbosas ou de comprimento inconsistente |
| Use títulos e estrutura dentro do próprio prompt | Escreva um longo parágrafo sem organização |
| Teste com casos extremos antes da implantação | Implante e espere o melhor |
| Controle de versão via aba de Histórico e itere mensalmente | Configure uma vez e nunca atualize |
Testes e Solução de Problemas
Problemas Comuns e Soluções
| Problema | Sintoma | Solução |
|---|---|---|
| Agente não usa ferramentas | Responde “Não tenho acesso” | Verifique se a ferramenta está habilitada, se a descrição está clara e se o Prompt incentiva explicitamente o uso. |
| Alucinação de dados | Inventa informações | Instrua o agente no Prompt de Personalidade a dizer “Não sei” quando a informação estiver faltando. |
| Respostas lentas | Consultas >10 segundos | Verifique o tamanho da janela de contexto, otimize a Base de Conhecimento, use execução paralela. |
| Falha de autenticação de ferramenta | Erro não autorizado | Verifique as credenciais nas configurações de Integrações, verifique validade e escopos do token. |
Lista de Verificação de Prontidão para Produção
Garanta que seu agente está pronto para implantação usando o framework de verificação da EKB.- ✅ Verificação de Configuração: Prompts estruturados, Modelo correto selecionado.
- ✅ Verificação de Segurança: Menor privilégio aplicado, fluxos de trabalho de aprovação definidos para ações de alto risco.
- ✅ Verificação de Testes: Caminho feliz, casos extremos e gatilhos de ferramentas testados no Chat.
- ✅ Documentação: Guias do usuário e etapas de solução de problemas preparados.
6. Otimização de Desempenho
Estratégias de melhoria contínua para manter a eficácia do agente:- Engenharia de Prompts de Sistema: Refine continuamente os Prompts de Personalidade com base nos logs de interação do usuário.
- Otimização da Base de Conhecimento: Audite regularmente os documentos da BC; otimize tamanhos de arquivo e convenções de nomenclatura.
- Gerenciamento de Contexto e Tokens: Equilibre a qualidade da resposta com o custo gerenciando o uso da janela de contexto.
- Uso de Ferramentas: Minimize chamadas desnecessárias; aproveite a execução paralela quando possível.