Agentes de IA

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)

Configuração da condição de encadeamento:

{
  "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.

Início

Guias

Exemplos

O que são agentes

Consultar agentes ativos

Como a seleção funciona

Tipos de condição

Encadeamento de agentes

Modelos disponíveis

​O que são agentes

​Consultar agentes ativos

​Como a seleção funciona

​Tipos de condição

​Encadeamento de agentes

​Modelos disponíveis

O que são agentes

Consultar agentes ativos

Como a seleção funciona

Tipos de condição

Encadeamento de agentes

Modelos disponíveis