Documentazione

Tutto quello che serve per portare in produzione agenti, modelli e automazioni con AICore. Endpoint REST, SDK tipizzati, esempi runnable e best practice per il deployment.

Quickstart

Installa l'SDK e fai la prima chiamata in meno di 2 minuti.

# npm
npm install @aicore/sdk

# python
pip install aicore

import { AICore } from "@aicore/sdk";

const ai = new AICore({ apiKey: process.env.AICORE_KEY });

const res = await ai.chat.completions.create({
  model: "atlas-70b",
  messages: [{ role: "user", content: "Summarize this email" }],
});

console.log(res.choices[0].message.content);

Playground

Prova i modelli direttamente dalla documentazione. Seleziona il modello, fai una domanda e ricevi la risposta in streaming.

Autenticazione

Tutte le richieste richiedono un Bearer token. Le chiavi si gestiscono dal pannello workspace con scope per ambiente (dev / staging / prod) e rotazione automatica ogni 90 giorni.

curl https://api.aicore.dev/v1/chat/completions \
  -H "Authorization: Bearer $AICORE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"atlas-70b","messages":[{"role":"user","content":"hello"}]}'

API REST

Base URL https://api.aicore.dev/v1. Tutti gli endpoint supportano streaming via SSE, function calling e response_format JSON-schema.

SDK

SDK ufficiali first-class in TypeScript, Python e Go. Retry esponenziale, streaming, typed response.

Webhook

Ricevi eventi in tempo reale per run completati, fallimenti, batch processati. Firma HMAC-SHA256.

{
  "id": "evt_01J9Z7...",
  "type": "agent.run.completed",
  "data": {
    "run_id": "run_xyz",
    "agent": "sales-qualifier",
    "duration_ms": 4318,
    "tokens": { "in": 1240, "out": 410 }
  },
  "created_at": "2026-06-17T14:22:01Z"
}

Modelli

Agenti

Definisci agenti con tool calling, memoria persistente e guardrail. Esegui sandbox-isolated.

const agent = ai.agents.define({
  name: "sales-qualifier",
  model: "atlas-70b",
  tools: [hubspot.getDeals, gmail.draftReply],
  guardrails: ["no-pii-leak", "tone-professional"],
});

const run = await agent.run({ input: "Qualify today's leads" });

Cookbook