Documentação da API

Autentique, crie sessões e transmita respostas dos seus agentes em tempo real (SSE).

Autenticação & Chaves

As rotas /we/** documentadas abaixo exigem o header Authorization: Bearer <TOKEN>, onde TOKEN é o token de sessão (JWT) obtido ao logar na Engine com Google.

Token de sessão (JWT) — válido para todas as rotas /we/** listadas nesta página.
API Key — gerada em Opções → API Keys, serve apenas para a API pública POST /api/v1/swarm/chat. Não funciona nestas rotas /we/**.

Base URL (produção): https://news-verifier-163762341148.southamerica-east1.run.app · (staging): https://news-verifier-staging-163762341148.southamerica-east1.run.app

Streaming SSE de mensagens

POST /we/chat/stream

Envia uma mensagem ao agente e recebe a resposta em streaming (Server-Sent Events). O corpo é JSON.

import httpx

url = "https://news-verifier-163762341148.southamerica-east1.run.app/we/chat/stream"
headers = {"Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json"}
body = {
    "agent_id": "SEU_AGENT_ID",
    "session_id": "web_123",
    "text": "Explique em 3 tópicos o que é streaming SSE.",
    "files": [],
    "model_override": None
}

async with httpx.AsyncClient(timeout=180) as client:
    async with client.stream("POST", url, headers=headers, json=body) as r:
        async for chunk in r.aiter_text():
            print(chunk, end="", flush=True)const res = await fetch("https://news-verifier-163762341148.southamerica-east1.run.app/we/chat/stream", {
    method: "POST",
    headers: {
        "Authorization": "Bearer SEU_TOKEN",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        agent_id: "SEU_AGENT_ID",
        session_id: "web_123",
        text: "Explique em 3 tópicos o que é streaming SSE.",
        files: [],
        model_override: null
    })
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    console.log(decoder.decode(value));
}curl -N https://news-verifier-163762341148.southamerica-east1.run.app/we/chat/stream \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"SEU_AGENT_ID","session_id":"web_123","text":"Explique em 3 tópicos o que é streaming SSE.","files":[],"model_override":null}'

Listagem de agentes

GET /we/agents

Retorna os agentes aos quais o usuário autenticado tem acesso.

import httpx

resp = httpx.get(
    "https://news-verifier-163762341148.southamerica-east1.run.app/we/agents",
    headers={"Authorization": "Bearer SEU_TOKEN"}
)
print(resp.json())const res = await fetch("https://news-verifier-163762341148.southamerica-east1.run.app/we/agents", {
    headers: { "Authorization": "Bearer SEU_TOKEN" }
});
console.log(await res.json());curl https://news-verifier-163762341148.southamerica-east1.run.app/we/agents \
  -H "Authorization: Bearer SEU_TOKEN"

Gerenciamento de sessões

POST /we/agents/{agent_id}/sessions

Cria uma nova sessão de conversa para o agente. Retorna { "session_id": "...", "title": "Nova conversa" }.

import httpx

resp = httpx.post(
    "https://news-verifier-163762341148.southamerica-east1.run.app/we/agents/SEU_AGENT_ID/sessions",
    headers={"Authorization": "Bearer SEU_TOKEN"}
)
print(resp.json())const res = await fetch("https://news-verifier-163762341148.southamerica-east1.run.app/we/agents/SEU_AGENT_ID/sessions", {
    method: "POST",
    headers: { "Authorization": "Bearer SEU_TOKEN" }
});
console.log(await res.json());curl -X POST https://news-verifier-163762341148.southamerica-east1.run.app/we/agents/SEU_AGENT_ID/sessions \
  -H "Authorization: Bearer SEU_TOKEN"

Modelos ativos

GET /we/models

Retorna o catálogo oficial de modelos disponíveis para os agentes.

import httpx

resp = httpx.get(
    "https://news-verifier-163762341148.southamerica-east1.run.app/we/models",
    headers={"Authorization": "Bearer SEU_TOKEN"}
)
print(resp.json())const res = await fetch("https://news-verifier-163762341148.southamerica-east1.run.app/we/models", {
    headers: { "Authorization": "Bearer SEU_TOKEN" }
});
console.log(await res.json());curl https://news-verifier-163762341148.southamerica-east1.run.app/we/models \
  -H "Authorization: Bearer SEU_TOKEN"