Agents

O que e um Agent

Um Agent e uma instancia de atendente virtual configuravel. Cada agent possui seu proprio prompt de sistema, skills, configuracoes de RAG, calendario e comportamento.

Campos do Agent

Campo	Descricao
name	Nome de exibicao
slug	Identificador unico (usado internamente)
system_prompt	Prompt de sistema que define personalidade e comportamento
skills	Lista de skills habilitadas (ver Skills)
rag_file_slugs	Arquivos RAG vinculados ao agent (ver RAG)
calendar_config_slug	Calendario vinculado (ver Calendarios)
timezone	Fuso horario do agent (ex: America/Sao_Paulo)

Como Funciona

1. Uma mensagem chega via WhatsApp
2. O consumer identifica o agent vinculado ao dispositivo (via rd_event ou configuracao padrao)
3. O agent-processor.service.ts monta o contexto:
   • System prompt do agent
   • Data/hora atual no timezone do agent
   • Contexto do CRM (deal stage, nome do deal)
   • Resultados do RAG (busca vetorial nos arquivos vinculados)
   • Variaveis de estado da conversa
4. O agent LangChain ReAct e invocado com as tools habilitadas
5. A resposta e enviada de volta ao contato

Contexto Injetado no Prompt

O agent recebe automaticamente:

• Data/hora: Formatada no timezone configurado
• Deal CRM: Stage atual e nome do deal no RD Station
• Estado da conversa: Variaveis salvas (ex: rd_lead_name, campos customizados)
• RAG: Trechos relevantes dos documentos vinculados, baseado na mensagem do usuario

Criando um Agent (Frontend)

1. Acesse /agents no painel
2. Clique em "Novo Agent"
3. Preencha nome, slug e system prompt
4. Selecione as skills desejadas
5. (Opcional) Vincule arquivos RAG
6. (Opcional) Vincule um calendario e defina timezone
7. Salve

Tip

O slug nao pode ser alterado apos a criacao. Escolha um identificador claro como atendimento-1 ou vendas-premium.