O que são agentes
Cada loja pode ter múltiplos agentes de IA com personalidades, instruções e regras diferentes. O sistema escolhe automaticamente qual agente responde cada mensagem com base em condições de ativação configuradas na plataforma.
Exemplos de uso com múltiplos agentes:
- Agente de triagem → redireciona leads para o setor correto
- Agente de vendas → foca em converter leads em clientes
- Agente de suporte → resolve dúvidas de clientes existentes
- Agente de cobrança → trata leads com pagamentos pendentes
Consultar agentes ativos
curl https://api.cordialy.ai/integrations/v1/agents \
-H "X-API-Key: SUA_KEY"
[
{
"id": "agent-001",
"name": "Agente de Triagem",
"model": "auto",
"priority": 1,
"is_active": true,
"is_default": false,
"condition_groups": [
{
"group_index": 0,
"logical_operator": "AND",
"conditions": [
{ "condition_type": "lead_status", "operator": "=", "value": "pending" },
{ "condition_type": "interaction_count", "operator": "<", "value": "3" }
]
}
]
},
{
"id": "agent-002",
"name": "Agente Padrão",
"model": "auto",
"priority": 99,
"is_active": true,
"is_default": true,
"condition_groups": []
}
]
Como a seleção funciona
O sistema avalia os agentes em ordem de prioridade (menor número = maior prioridade):
- Para cada agente (exceto o padrão), avalia os
condition_groups
- Dentro de um grupo: todas as condições devem ser verdadeiras (AND)
- Entre grupos: basta um ser verdadeiro (OR)
- Primeiro agente que passar é ativado
- Se nenhum passar, usa o agente com
is_default: true
Mensagem recebida
→ Agente prioridade 1: condições ✅ → ATIVADO
→ (agentes seguintes não são avaliados)
Mensagem recebida
→ Agente prioridade 1: condições ❌
→ Agente prioridade 2: condições ❌
→ Agente padrão → ATIVADO
Tipos de condição
| Tipo | Exemplo de uso |
|---|
lead_status | Ativa só para leads in_progress |
interaction_count | Ativa após X mensagens trocadas |
message_contains | Detecta palavras-chave (“preço”, “cancelar”) |
media_type | Ativa quando lead enviar áudio ou imagem |
time_of_day | Ativa em horário comercial ou fora dele |
conversation_stage | Ativa em fase específica do funil |
last_agent_id | Encadeia agentes em sequência |
sentiment | Detecta sentimento positivo/negativo/neutro |
has_open_appointment | Verifica se lead tem agendamento ativo |
Encadeamento de agentes
Use last_agent_id para criar fluxos sequenciais:
Lead entra → Agente de Triagem (prioridade 1)
→ qualifica o lead
→ passa para Agente de Vendas (prioridade 2, condição: last_agent_id = triagem)
→ fecha a venda
→ passa para Agente de Onboarding (prioridade 3, condição: last_agent_id = vendas)
{
"condition_type": "last_agent_id",
"operator": "=",
"value": "agent-001"
}
Modelos disponíveis
| Valor | Comportamento |
|---|
auto | Usa o modelo padrão configurado na loja (recomendado) |
gemini | Google Gemini — boa performance em português |
openai | OpenAI GPT-4 — alto desempenho geral |
Via API você pode apenas consultar os agentes. Para criar ou editar agentes, acesse a plataforma em Configurações → Agentes.
