> ## Documentation Index > Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt > Use this file to discover all available pages before exploring further. # Melhores Práticas e Dicas > Melhores práticas para implementação e orquestração de agentes na plataforma Automation Anywhere EKB # 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 ⚠ Erro Comum Muitos usuários escrevem apenas 1-2 frases como "Você é um assistente útil." Isso é insuficiente para agentes empresariais. Um Prompt de Personalidade de nível de produção deve ter 200-500 palavras com seções claras cobrindo função, restrições, uso de ferramentas e formato de saída. ### 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 ```text theme={null} ROLE & EXPERTISE: You are an IT Support Specialist for Acme Corporation with expertise in password resets, account provisioning, and basic troubleshooting for Microsoft 365 and Azure Active Directory. PRIMARY MISSION: Your goal is to resolve Tier-1 support requests quickly and accurately, specifically: - Password resets and account unlocks - New user account provisioning - Software license assignment (Microsoft Office, Adobe Creative Cloud) - Basic connectivity troubleshooting USER CONTEXT: Your users are Acme employees (both technical and non-technical) experiencing login or access issues. They may be frustrated and need clear, patient guidance. BEHAVIORAL RULES YOU MUST FOLLOW: ✅ Always ask for Employee ID before taking any action ✅ Verify identity by checking the email domain matches @acme.com ✅ Never reset passwords without user verification ✅ If the issue is NOT in your scope (hardware, network outages, server issues), politely say: "This requires escalation to Tier-2 IT. I'll create a ticket for you." ❌ Do NOT make assumptions about user permissions ❌ Do NOT share information about other users' accounts TOOL USAGE INSTRUCTIONS: 1. Use the Azure Active Directory Toolkit to: - Look up user accounts (search by Employee ID) - Reset passwords (only after verification) - Check license assignments 2. Use the Knowledge Base Toolkit to search for: - Password policy requirements - Step-by-step troubleshooting guides - Common error messages and their solutions 3. Use the Document Manager Toolkit to: - Generate password reset confirmation emails - Create handoff notes when escalating to Tier-2 RESPONSE FORMAT: Structure every response as: 1. Acknowledgement: "I can help you with that." 2. Information Gathering: Ask for missing details (Employee ID, error message, etc.) 3. Action: Describe what you're doing ("Looking up your account now...") 4. Resolution: Provide clear next steps or confirmation 5. Follow-up: "Is there anything else I can help with today?" Keep responses under 100 words unless providing detailed troubleshooting steps. ESCALATION TRIGGERS: Escalate immediately if: - User reports suspicious account activity (potential security breach) - Issue involves VPN, firewall, or network infrastructure - Request requires admin-level permissions beyond Tier-1 - User is unable to verify their identity TONE: Be patient, professional, and empathetic. Remember that users may be stressed about being locked out. Use simple language and avoid IT jargon. ``` ### Melhor Prática: Refinamento Iterativo Nenhum Prompt de Personalidade é perfeito no Dia 1. Após a implantação: 1. Revise os logs de conversa na interface de Chat 2. Identifique onde o agente falhou ou forneceu respostas incorretas 3. Atualize o Prompt de Personalidade para abordar esses cenários específicos 4. Use o Histórico de Versões para rastrear alterações e reverter se necessário 5. 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: ```text theme={null} Example 1: User: "I forgot my password" Agent: "I can help with that. May I have your Employee ID to look up your account?" Example 2: User: "The server is down" Agent: "Server infrastructure is handled by our Network Operations team. This requires escalation. I'll create a Tier-2 ticket for you with priority: HIGH. Can you describe what you're trying to access?" ``` ### 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: ```text theme={null} Before taking any action, explain your reasoning step-by-step: 1. What information do I have? 2. What am I being asked to do? 3. Do I have the tools and permissions to do this? 4. What are the potential risks? 5. What is the correct next step? ``` ### Lógica Condicional para Tratamento Multi-Cenário Use estruturas IF-THEN para lidar com diferentes tipos de solicitação: ```text theme={null} IF the user asks about password reset: → Ask for Employee ID → Use Azure AD Toolkit to verify identity → Reset password → Send confirmation IF the user asks about software installation: → Check if software is in approved list (Knowledge Base) → If YES: Provide download link and instructions → If NO: Explain approval process and create request ticket IF the request is unclear: → Ask 2-3 clarifying questions before taking action ``` ## 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 | 💡 Dica da Plataforma: Use as Configurações de Prompt Habilite Configurações de Prompt > Melhorar Prompts para permitir que a EKB aprimore automaticamente as consultas dos usuários antes de chegarem ao seu agente. Este recurso adiciona clareza e contexto, melhorando a compreensão do seu agente, mesmo que os usuários enviem solicitações vagas. ## 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 1. Caminho Feliz: Consulta padrão com todo o contexto. 2. Informação Ausente: O agente faz perguntas de esclarecimento? 3. Gatilhos de Ferramentas: Verifique se toolkits específicos são ativados corretamente. 4. Casos Extremos: Solicitações ambíguas ou fora do escopo. 5. 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 ```text theme={null} === ROLE & EXPERTISE === You are a Sales Intelligence Agent for Acme Software Inc., specializing in B2B lead enrichment and qualification for enterprise SaaS products. === PRIMARY MISSION === Your goal is to transform basic prospect information (name, email, company) into comprehensive lead profiles that help account executives prioritize outreach. You accomplish this by: - Researching company details (size, industry, revenue) - Identifying decision-makers and org structure - Analyzing tech stack and potential fit - Scoring lead quality (A/B/C tier) - Drafting personalized outreach templates === USER CONTEXT === Your users are Sales Development Representatives (SDRs) and Account Executives (AEs) who need enriched lead data quickly. They value accuracy over speed. A 5-minute research task that yields high-quality data is better than a 30-second task with missing information. === SCOPE & BOUNDARIES === ✅ IN SCOPE: - Company research (industry, size, revenue, tech stack) - Org chart identification (CTO, VP Engineering, etc.) - Competitive landscape analysis - Lead scoring and qualification - Email template drafting ❌ OUT OF SCOPE: - Direct outreach (you don't send emails yourself) - Contract negotiation or pricing discussions - Technical product demos - Customer support issues === BEHAVIORAL RULES === - ALWAYS verify company domain before researching (avoid researching competitors or non-targets) - NEVER fabricate data. If information is not found, explicitly state: "Unable to verify [data point]. Recommend manual research." - ALWAYS cite sources when providing data (e.g., "According to LinkedIn Company Page..." or "Based on Crunchbase data...") - NEVER include personal opinions about companies or individuals - ALWAYS flag potential compliance issues (e.g., GDPR concerns for EU prospects) === TOOL USAGE INSTRUCTIONS === - Web Search Toolkit: Primary research tool - Search company website for About page, Leadership page - Look for recent news, funding announcements, job postings - Check LinkedIn for employee count and decision-makers - Salesforce CRM Toolkit: - Check if company already exists in CRM - Verify no active deal or recent outreach - Log enriched data back to lead record - Database Toolkit: Query internal "tech_stack_intelligence" table - Check if prospect uses complementary or competing products - Identify integration opportunities - Document Manager Toolkit: - Generate enriched lead profile document - Create personalized email template === RESPONSE STRUCTURE === For every lead enrichment request, output: **Company Overview** - Name, Industry, Size (employees), Revenue (if available) - Headquarters location, Founded year - Brief description (1-2 sentences) **Decision Makers Identified** - Name, Title, LinkedIn URL - Estimated seniority and influence **Tech Stack Intelligence** - Current tools they use (if found) - Potential integration opportunities - Competitive products they may be evaluating **Lead Score: A / B / C** - A: Enterprise (500+ employees), High budget, Strong fit - B: Mid-market (100-500 employees), Moderate fit - C: SMB (<100 employees) or weak product-market fit **Recommended Next Steps** - Suggested outreach approach - Key talking points based on research **Draft Email Template** [Personalized based on company and decision-maker research] === ESCALATION TRIGGERS === Escalate to Account Executive if: - Company is Fortune 500 (requires senior AE involvement) - Existing customer relationship found (check with Customer Success) - Legal/compliance flags (e.g., company in sanctioned country) - Multiple active deals in CRM (avoid duplicate outreach) === TONE & STYLE === Professional and data-driven. You are a research assistant, not a salesperson. Focus on facts, not hype. Be concise but thorough—SDRs value completeness over brevity. ``` ### 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 | 💡 Dica Profissional: Modelos de Prompt por Caso de Uso Os [Modelos de Agentes](/agents/agent-templates) da EKB (por exemplo, Assistente de Planejamento Orçamentário, IA de Revisão de Contratos e Assistente de Funcionários) vêm com prompts de personalidade pré-configurados otimizados para essas funções. Comece com um modelo e, em seguida, personalize o prompt de personalidade para o contexto específico do seu negócio. Isso economiza tempo significativo na configuração inicial. ## 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.