Aillom Docs
Dashboard

Criando seu Primeiro Agente

Agentes são o núcleo da plataforma. Cada agente tem um prompt de sistema, pode ter ferramentas e bases de conhecimento vinculadas.

1. Criar o Agente

O agente aceita title e prompt. O modelo de IA utilizado é gerenciado pela plataforma — você não precisa (nem pode) especificá-lo.

curl -X POST https://api.mex.aillom.com.br/api/agents \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Assistente de Vendas",
    "prompt": "Você é um assistente de vendas especializado em produtos de tecnologia. Seja sempre cordial e objetivo."
  }'

Resposta:

{
  "id": "uuid-do-agente",
  "title": "Assistente de Vendas",
  "prompt": "Você é um assistente de vendas...",
  "tools": [],
  "knowledge_bases": [],
  "user_id": "uuid-do-usuario",
  "created_at": "2025-01-01T00:00:00Z"
}

:::info Modelo de IA O modelo de linguagem utilizado pelos agentes é configurado centralmente pela plataforma Aillom MEX. O sistema seleciona automaticamente o melhor provedor disponível (com fallback automático entre provedores). :::

2. Vincular uma Base de Conhecimento

Primeiro crie uma base de conhecimento com uma URL:

curl -X POST https://api.mex.aillom.com.br/api/knowledge-base \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Site da Empresa",
    "source_type": "url",
    "source_url": "https://suaempresa.com.br"
  }'

Depois vincule ao agente:

curl -X POST https://api.mex.aillom.com.br/api/agents/{id}/knowledge-bases \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "knowledge_base_id": "uuid-da-kb" }'

3. Conectar ao WhatsApp

Com o agente criado, crie uma instância WhatsApp e vincule:

curl -X POST https://api.mex.aillom.com.br/api/whatsapp \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "whatsapp-vendas",
    "agent_id": "uuid-do-agente"
  }'

Escaneie o QR Code retornado para conectar o número.

4. Instalar o Webchat

Adicione o script no seu site HTML:

<script>
  window.AillomConfig = {
    agentHash: 'hash-publico-do-agente'
  };
</script>
<script src="https://mex.aillom.com.br/webchat.js" async></script>

:::info O agentHash é gerado automaticamente quando você ativa o Webchat nas configurações do agente no dashboard. :::