Como integrar a Cortex com meus sistemas via API?

A Cortex expõe uma API REST compatível com OpenAI — qualquer SDK do ecossistema OpenAI (openai, langchain, llamaindex) funciona apontando a base_url para a Cortex.

Passo a passo:

1. Gere uma API Key em Configurações → Conta → API Keys, com escopo apropriado
2. Instale o SDK: pip install openai (ou equivalente)
3. Use a API key em requisições:

from openai import OpenAI

client = OpenAI(
    api_key="sk-cortex-...",
    base_url="https://cortex.suaempresa.com/api"
)

resposta = client.chat.completions.create(
    model="revisor-contratos",  # ID do seu agente
    messages=[
        {"role": "user", "content": "Analise este contrato: [texto]"}
    ],
    temperature=0.2,
)
print(resposta.choices[0].message.content)

Importante:

• Nunca exponha a API key no frontend — chame sempre via backend
• Use timeouts altos (60-120s) para modelos com raciocínio
• Implemente retry com backoff exponencial para 429/503
• Passe o campo user (e-mail do usuário final) para auditoria melhorar

📖 Documentação completa na Wiki:

• APIs e Integrações — referência completa
• Ferramentas e Funções