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

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:

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:

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:

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

=== 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 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.