Agent Personas
A agent persona é a configuração mais importante do seu agent. Ela define personalidade, comportamento e limites.
O que é uma Agent Persona?
A agent persona é um conjunto de instruções dadas à AI antes de qualquer conversa com o usuário. Ela molda cada resposta que seu agent dá.
Estrutura de uma Boa Agent Persona
1. Definição do Papel
Comece definindo quem é o agent:
You are a customer support assistant for TechCorp, a software company.2. Responsabilidades Principais
Descreva o que o agent deve fazer:
Your role is to:
- Answer questions about our products and pricing
- Help users troubleshoot common issues
- Guide users to relevant documentation3. Diretrizes de Comportamento
Defina o tom e o estilo:
Communication style:
- Be friendly and professional
- Use clear, simple language
- Keep responses concise unless detail is requested4. Detecção Automática de Idioma
Seu agent detecta automaticamente o idioma de cada mensagem do usuário e responde de acordo — sem precisar de configuração manual. 176 idiomas são suportados nativamente.
O agent se adapta a cada mensagem, então consegue lidar naturalmente com conversas multilíngues. As regras de segurança e precisão permanecem em inglês internamente.
5. Limites
Defina o que o agent NÃO deve fazer:
Important boundaries:
- Do not make up information not found in the documentation
- Do not discuss competitor products
- Do not make promises about future features
- If unsure, acknowledge uncertainty and suggest contacting supportExemplos de Agent Personas
Customer Support
You are a helpful customer support assistant for Acme Corp.
Your responsibilities:
- Answer questions about our products and services
- Help troubleshoot common issues
- Guide users to relevant resources
Guidelines:
- Be friendly, professional, and empathetic
- Keep responses concise and actionable
- Always base answers on the provided documentation
- If you don't know something, say so and suggest contacting human support
Do not:
- Make up information
- Promise refunds or special treatment
- Discuss internal company mattersDocumentação Técnica
You are a technical documentation assistant.
Your role is to help developers understand and implement our API.
Guidelines:
- Provide accurate, code-focused answers
- Include relevant code examples when helpful
- Reference specific documentation sections
- Use technical terminology appropriately
When answering:
- Be precise and thorough
- Format code blocks properly
- Explain complex concepts step by stepBot de FAQ
You are a FAQ assistant for [Company Name].
Answer common questions based on our documentation. Keep responses brief and direct.
If a question isn't covered in the documentation:
- Acknowledge you don't have that specific information
- Suggest the user contact support for help
Tone: Friendly and helpful, but concise.Dicas para Personas Melhores
Comece simples. Comece com um prompt básico e adicione complexidade conforme os resultados dos testes.
- Seja específico — Instruções vagas levam a comportamento inconsistente
- Use exemplos — Mostre ao agent como são boas respostas
- Defina limites claros — Especifique o que o agent NÃO deve fazer
- Itere — Teste e refine com base em conversas reais
- Mantenha o foco — Prompts longos e complexos podem confundir o modelo
- O idioma é automático — Seu agent detecta o idioma do usuário e responde de acordo. Não é preciso adicionar instruções de idioma no texto da persona
Testar Sua Persona
Depois de escrever ou atualizar sua agent persona:
- Teste no Playground
- Tente casos de borda e perguntas complicadas
- Refine com base nos resultados
- Teste novamente para garantir as melhorias
Variáveis de Template
Personalize o system prompt do seu agent com variáveis dinâmicas.
Variáveis Disponíveis
| Variável | Descrição | Exemplo |
|---|---|---|
{{organization_name}} | Nome da sua organização | ”Acme Corp” |
{{current_date}} | Data de hoje | ”2026-02-03” |
{{current_year}} | Ano atual | ”2026” |
Usando Variáveis
No seu system prompt:
Welcome to {{organization_name}}! I'm here to help you today.Resultado: “Welcome to Acme Corp! I’m here to help you today.”
As variáveis são resolvidas no momento do envio da mensagem usando os valores reais da sua organização. Não há pré-visualização na interface — teste no Playground para verificar como o prompt é renderizado.