Guia do desenvolvedor — integrar o Logus

O Logus decide — antes de uma mensagem chegar ao LLM — se ela pode ou não ser respondida. Você foi convidado por um cliente que contratou o Logus. Dois modos de integração: você escolhe.

🅰 Modo A — Manual (~15 linhas): você mantém o controle total

Antes de responder com o provedor de IA do cliente, chame o endpoint de decisão do Logus. ALLOW → responda normalmente; DENY → devolva a justificativa da negação (em português). A chave do provedor fica com você.

curl -X POST https://api.logus-align.com.br/v1/decision \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_id": "prov_xxx",
    "conversation_id": "conv_123",
    "request_id": "req_456",
    "messages": [
      {"role": "user", "content": "mensagem do cliente final"}
    ]
  }'

Resposta: decision: "ALLOW" ou decision: "DENY" + justification (pt-BR) + credits_consumed. Contrato completo: /docs.

🅱 Modo B — Proxy (1 linha): conveniência máxima

🔑 Aviso transparente: no modo proxy o bot aponta para o Logus, e o Logus encaminha as mensagens aprovadas ao provedor de IA do cliente usando a chave do provedor (guardada criptografada por nós). Você mantém o controle da conta; se preferir não compartilhar a chave, escolha o Modo A.

Aponte o base_url do bot para o Logus (compatível com OpenAI). Uma linha:

base_url = "https://api.logus-align.com.br/v1"  # em vez de https://api.deepseek.com/v1

Mensagens DENY recebem uma recusa segura formatada. O modo proxy está em lançamento; até lá, use o Modo A.

🔐 Chave de API

Seu cliente compartilha a chave de API do Logus por canal seguro (nunca por e-mail). Authorization: Bearer lg_….

🗓️ Retenção

As perguntas enviadas para julgamento ficam retidas por 30 dias para verificação de gastos e depois são eliminadas automaticamente (minimização LGPD).