Documentação do SDK

Integre a governança e auditoria da Capsule Hub na sua aplicação em menos de 5 minutos usando nosso SDK oficial para Node.js ou Python.

1Instalação

Instale o SDK oficial da Capsule através do seu gerenciador de pacotes preferido.

$npm install @capsule-hub/sdk

2Inicialização e Ingestão

Para autenticar, você precisará da sua API_KEY e do AGENT_ID. Ambos podem ser obtidos gratuitamente criando uma conta e acessando o Cockpit.

Node.js / TypeScript

capsule.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
import { CapsuleHub } from '@capsule-hub/sdk';

// 1. Inicialize com a sua API Key (obtida no Dashboard)
const capsule = new CapsuleHub({
  apiKey: process.env.CAPSULE_API_KEY
});

// 2. Dispare a ingestão de log da sua IA
async function main() {
  const result = await capsule.ingest({
    agentId: 'seu_agent_id',
    input: 'Qual a capital do Brasil?',
    output: 'A capital do Brasil é Brasília.',
    cost: 0.0015, // Custo em dólares da chamada LLM (Opcional)
    metadata: { userId: '123' } // Metadados indexáveis (Opcional)
  });
  
  // O log foi imutavelmente gravado e você recebe a hash SHA-256
  console.log('Log Auditado:', result.hash);
}

main();

Python

capsule.py

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
from capsule_hub import CapsuleHub
import os

# 1. Inicialize com a sua API Key
capsule = CapsuleHub(api_key=os.getenv("CAPSULE_API_KEY"))

# 2. Dispare a ingestão de log da sua IA
result = capsule.ingest(
    agent_id="seu_agent_id",
    input="Qual a capital do Brasil?",
    output="A capital do Brasil é Brasília.",
    cost=0.0015,
    metadata={"user_id": "123"}
)

print(f"Log Auditado: {result.hash}")

3Verificação via API REST (Opcional)

Se preferir não usar o SDK, você pode realizar chamadas HTTP diretas para nossa API.

POSThttps://capsulehub.com/api/v1/ingest

Header obrigatório: X-API-KEY

Pronto para blindar sua IA?

Crie sua conta agora para obter sua API Key e comece a auditar os logs da sua aplicação gratuitamente.

Começar Gratuitamente