Documentação dos Campos de Configuração

Campos Básicos

Nome e Identificação

O agente precisa ser configurado com informações básicas que determinam sua identidade e funcionamento.

Nome do Agente

name: Define como o agente será identificado nas conversas.

Exemplos válidos:

• “Assistente de Vendas”
• “Suporte Técnico”
• “João”
• “Maria”

Provedor do Serviço

provider: Especifica qual serviço de IA será utilizado.

Provedores disponíveis:

• “openai” (ChatGPT)
• “anthropic” (Claude)
• “gemini” (Google)
• “deepseek” (DeepSeek)

Chave de API

apikey: Credencial necessária para autenticação com o provedor escolhido.

• Deve ser obtida através do site oficial do provedor selecionado
• Mantenha esta chave em segurança e nunca a compartilhe

Configuração do Modelo

Seleção do Modelo

model: Especifica qual modelo de IA será utilizado. A disponibilidade depende do provedor selecionado.

OpenAI

Documentação: https://platform.openai.com/docs/models

• gpt-4o
• gpt-4o-mini
• gpt-3.5-turbo

Claude

Documentação: https://docs.anthropic.com/en/docs/about-claude/models

• claude-3-5-sonnet-latest
• claude-3-5-haiku-latest
• claude-3-opus-latest

Gemini

Documentação: https://ai.google.dev/models/gemini

• gemini-2.0-flash-exp
• gemini-1.5-pro
• gemini-1.5-flash

DeepSeek

Documentação: https://api-docs.deepseek.com/quick_start/pricing

• deepseek-chat

• deepseek-reasoner

Configurações de Comportamento

Prompt Base (basePrompt)

Instruções iniciais para definir o comportamento do agente

Exemplo para assistente de vendas:

“Você é um assistente especializado em vendas, focado em ajudar clientes a encontrar os produtos ideais. Mantenha um tom profissional e amigável.”

Exemplo para suporte:

“Você é um agente de suporte técnico especializado em nossos produtos. Forneça respostas claras e objetivas para ajudar os clientes a resolverem seus problemas.”

Parâmetros de Geração

• temperature: Controla a criatividade das respostas (0-100)

  • 0-30: Respostas mais conservadoras e precisas

  • 30-70: Equilíbrio entre criatividade e precisão

  • 70-100: Respostas mais criativas e variadas

• maxTokens: Limite máximo de tokens por resposta

  • Recomendado: 1000-4000 para respostas detalhadas

  • Para respostas curtas: 500-1000

  • Limite máximo varia por modelo

• diversityLevel: Controla a diversidade das respostas (0-100)

  • Valores mais altos geram respostas mais variadas

  • Recomendado: 30-70 para uso geral

• frequencyPenalty: Penalidade para repetição de palavras (0-100)

  • Valores mais altos reduzem repetições

  • Recomendado: 20-50 para comunicação natural

• presencePenalty: Penalidade para manter foco no tópico (0-100)

  • Valores mais altos incentivam mudanças de tópico

  • Recomendado: 10-30 para manter coerência

Configurações de Interação

Mensagens

• signMessages: Se verdadeiro, adiciona a assinatura do agente nas mensagens

  • Útil para identificar quem está enviando a mensagem

• readMessages: Se verdadeiro, marca as mensagens como lidas ao responder

  • Recomendado para simular comportamento humano

Exemplos de Configuração

Assistente de Vendas

{
  "name": "Assistente de Vendas",
  "provider": "openai",
  "model": "gpt-4",
  "basePrompt": "Você é um assistente de vendas especializado...",
  "temperature": 70,
  "maxTokens": 2000,
  "diversityLevel": 50,
  "frequencyPenalty": 30,
  "presencePenalty": 20,
  "signMessages": true,
  "readMessages": true
}

Suporte Técnico

{
  "name": "Suporte Técnico",
  "provider": "anthropic",
  "model": "claude-3-sonnet-20240229",
  "basePrompt": "Você é um agente de suporte técnico...",
  "temperature": 30,
  "maxTokens": 3000,
  "diversityLevel": 40,
  "frequencyPenalty": 40,
  "presencePenalty": 15,
  "signMessages": true,
  "readMessages": true
}

Dicas de Otimização

1. Ajuste Gradual: Comece com valores moderados e ajuste conforme necessário

2. Teste o Base Prompt: Verifique se as instruções estão claras e completas

3. Monitore o Desempenho: Observe as respostas e ajuste os parâmetros para melhor adequação

4. Backup: Mantenha um backup das configurações que funcionaram bem

5. Documentação: Registre as alterações e seus impactos para referência futura