Agent Skills

Mensagem recebida
      ↓
Agent Cortex avalia skills ativas
      ↓
Skill(s) mais relevante(s) selecionada(s)
      ↓
Conteúdo da skill injetado no contexto
      ↓
IA gera resposta usando as instruções da skill

GET /api/agents/{agentId}/skills

{
  "skills": [
    {
      "id": "skill_abc123",
      "organizationId": "org_xyz",
      "agentId": "agent_123",
      "slug": "lidar-com-reembolso",
      "name": "Lidar com Pedido de Reembolso",
      "description": "Ativada quando um cliente solicita reembolso ou menciona problemas de cobrança.",
      "content": "Ao lidar com pedido de reembolso:\n1. Reconheça a frustração do cliente\n2. Solicite o número do pedido\n3. Verifique elegibilidade conforme a política de reembolso\n4. Processe ou escale conforme necessário",
      "status": "active",
      "pinned": false,
      "origin": "manual",
      "scope": "agent",
      "metadata": null,
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-15T10:00:00.000Z",
      "lastReviewedAt": "2025-01-15T10:00:00.000Z"
    }
  ],
  "approvals": []
}

POST /api/agents/{agentId}/skills
Content-Type: application/json

{
  "name": "Lidar com Pedido de Reembolso",
  "description": "Quando um cliente menciona cobrança, reembolso ou contestação de pagamento.",
  "content": "Ao lidar com pedido de reembolso:\n1. Reconheça o problema com empatia\n2. Solicite o número do pedido ou nota fiscal\n3. Verifique a data da compra (reembolsos aceitos em até 30 dias)\n4. Se elegível: confirme o início do reembolso e prazo (3-5 dias úteis)\n5. Se não elegível: explique a política claramente e ofereça alternativas",
  "status": "active",
  "scope": "agent"
}

curl -X POST "https://seu-dominio.com/api/agents/agent_123/skills" \
  -H "Content-Type: application/json" \
  -H "Cookie: next-auth.session-token=SEU_TOKEN_DE_SESSAO" \
  -d '{
    "name": "Lidar com Pedido de Reembolso",
    "content": "Quando um reembolso é solicitado, reconheça com empatia e verifique a elegibilidade.",
    "status": "active"
  }'

const response = await fetch(`/api/agents/${agentId}/skills`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'Lidar com Pedido de Reembolso',
    content: 'Quando um reembolso é solicitado, reconheça com empatia e verifique a elegibilidade.',
    status: 'active',
  }),
});

const skill = await response.json();

PATCH /api/agents/{agentId}/skills/{skillId}
Content-Type: application/json

GET /api/agents/{agentId}/skills/packs

{
  "packs": [
    {
      "id": "pack_customer_support",
      "name": "Suporte ao Cliente Essencial",
      "description": "Skills fundamentais para lidar com consultas de suporte, escalonamentos e problemas comuns.",
      "skills": [
        { "name": "Escalar para Humano", "description": "Quando escalar para um atendente humano" },
        { "name": "Reconhecer Frustração", "description": "Desescalonamento empático" },
        { "name": "Solicitar Mais Informações", "description": "Quando a IA precisa de mais contexto" }
      ]
    }
  ]
}

POST /api/agents/{agentId}/skills/packs/apply
Content-Type: application/json

POST /api/agents/{agentId}/skills/propose

POST /api/agents/{agentId}/skills/propose-from-rag

{
  "createdCount": 3,
  "approvals": [
    {
      "id": "approval_abc",
      "actionType": "agent_skill.create",
      "payload": {
        "name": "Lidar com Devoluções de Produtos",
        "content": "Quando o cliente pergunta sobre devolução de produtos..."
      }
    }
  ],
  "skipped": 1
}

POST /api/agents/{agentId}/skills/optimize

GET /api/agents/{agentId}/skills/cortex-mode

{
  "configuredMode": "advisory",
  "effectiveMode": "advisory"
}

PATCH /api/agents/{agentId}/skills/cortex-mode
Content-Type: application/json

{
  "mode": "active"
}

PUT /api/agents/{agentId}/specialists
Content-Type: application/json

{
  "targetAgentId": "agent_specialist_456",
  "name": "Especialista em Vendas Enterprise",
  "description": "Lida com precificação e contratos para clientes enterprise"
}