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:

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:

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:
What information do I have?
What am I being asked to do?
Do I have the tools and permissions to do this?
What are the potential risks?
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

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

=== 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 (&lt;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.

Get Started!

Offerings

Chat

Agents

Knowledge Base

Workflows

Public Chatbot

Project Settings

My Account

Platform Admin

SDK

General Information

Melhores Práticas e Dicas

1. Melhores Práticas para Implementação e Orquestração

Planejamento Estratégico

Identificando Casos de Uso de Alto Valor

Definindo o Escopo do Agente

Padrões de Design de Agentes

Estratégia de Base de Conhecimento

Engenharia de Prompts (Prompts de Personalidade)

Por que os Prompts de Personalidade São Importantes

Anatomia de um Prompt de Personalidade Robusto

Exemplo Completo de Prompt de Personalidade: Agente de Suporte de TI

Melhor Prática: Refinamento Iterativo

Técnicas Avançadas de Engenharia de Prompts

Exemplos Few-Shot (Aprendizado no Contexto)

Restrições Negativas (O Que NÃO Fazer)

Raciocínio Chain-of-Thought

Lógica Condicional para Tratamento Multi-Cenário

Testando Seu Prompt de Personalidade

Orquestração de Ferramentas e Toolkits

Fluxo de Trabalho de Testes e Iteração

Governança e Conformidade

O Que Vai no Prompt de Personalidade?

Exemplo do Mundo Real: Agente de Enriquecimento de Leads de Vendas

O Que Fazer e O Que Não Fazer no Prompt de Personalidade

Testes e Solução de Problemas

Problemas Comuns e Soluções

Lista de Verificação de Prontidão para Produção

6. Otimização de Desempenho

​1. Melhores Práticas para Implementação e Orquestração

​Planejamento Estratégico

​Identificando Casos de Uso de Alto Valor

​Definindo o Escopo do Agente

​Padrões de Design de Agentes

​Estratégia de Base de Conhecimento

​Engenharia de Prompts (Prompts de Personalidade)

​Por que os Prompts de Personalidade São Importantes

​Anatomia de um Prompt de Personalidade Robusto

​Exemplo Completo de Prompt de Personalidade: Agente de Suporte de TI

​Melhor Prática: Refinamento Iterativo

​Técnicas Avançadas de Engenharia de Prompts

​Exemplos Few-Shot (Aprendizado no Contexto)

​Restrições Negativas (O Que NÃO Fazer)

​Raciocínio Chain-of-Thought

​Lógica Condicional para Tratamento Multi-Cenário

​Testando Seu Prompt de Personalidade

​Orquestração de Ferramentas e Toolkits

​Fluxo de Trabalho de Testes e Iteração

​Governança e Conformidade

​O Que Vai no Prompt de Personalidade?

​Exemplo do Mundo Real: Agente de Enriquecimento de Leads de Vendas

​O Que Fazer e O Que Não Fazer no Prompt de Personalidade

​Testes e Solução de Problemas

​Problemas Comuns e Soluções

​Lista de Verificação de Prontidão para Produção

​6. Otimização de Desempenho

1. Melhores Práticas para Implementação e Orquestração

Planejamento Estratégico

Identificando Casos de Uso de Alto Valor

Definindo o Escopo do Agente

Padrões de Design de Agentes

Estratégia de Base de Conhecimento

Engenharia de Prompts (Prompts de Personalidade)

Por que os Prompts de Personalidade São Importantes

Anatomia de um Prompt de Personalidade Robusto

Exemplo Completo de Prompt de Personalidade: Agente de Suporte de TI

Melhor Prática: Refinamento Iterativo

Técnicas Avançadas de Engenharia de Prompts

Exemplos Few-Shot (Aprendizado no Contexto)

Restrições Negativas (O Que NÃO Fazer)

Raciocínio Chain-of-Thought

Lógica Condicional para Tratamento Multi-Cenário

Testando Seu Prompt de Personalidade

Orquestração de Ferramentas e Toolkits

Fluxo de Trabalho de Testes e Iteração

Governança e Conformidade

O Que Vai no Prompt de Personalidade?

Exemplo do Mundo Real: Agente de Enriquecimento de Leads de Vendas

O Que Fazer e O Que Não Fazer no Prompt de Personalidade

Testes e Solução de Problemas

Problemas Comuns e Soluções

Lista de Verificação de Prontidão para Produção

6. Otimização de Desempenho