Vai al contenuto principale

SDK Server

Crea integrazioni backend con SDK type-safe.

Ottenere la Tua Chiave API

Prima di utilizzare gli SDK, avrai bisogno di una chiave API dal tuo pannello di controllo itellicoAI.
1

Vai a Sviluppatori

Vai al tuo pannello di controllo itellicoAI e naviga su Sviluppatori dalla barra laterale.
2

Vai a Chiavi API

Clicca su Chiavi API nella sezione Sviluppatori.
3

Crea la tua chiave

Clicca sul pulsante Crea Chiave API nell’angolo in alto a destra.
Pannello delle chiavi API che mostra come creare una nuova chiave API
Pannello delle chiavi API che mostra come creare una nuova chiave API
4

Copia e usa con il tuo SDK

Copia la chiave API generata e conservala in modo sicuro. Usa questa chiave durante l’inizializzazione dell’SDK.
Non condividere mai la tua chiave API e non caricarla nel controllo di versione. Usa variabili d’ambiente per memorizzare la tua chiave in modo sicuro.

Perché Usare gli SDK?

Type Safety

Definizioni TypeScript complete e type hint Python per tutti i metodi API

Autenticazione Semplificata

Gestione integrata della chiave API—nessun header manuale necessario

Errori Migliori

Eccezioni strutturate per un debugging più facile

Meno Codice

Metodi puliti invece di richieste HTTP manuali

Confronto Rapido

Creare un Agente

from itellicoai import Itellicoai

# Initialize client
client = Itellicoai(
    api_key="your-api-key"
)

# Create an agent
agent = client.agents.create(
    account_id="your-account-id",
    name="Customer Support Agent",
    model={
        "provider": "openai",
        "model": "gpt-4o-mini"
    },
    voice={
        "provider": "elevenlabs",
        "voice_id": "EXAVITQu4vr4xnSDxMaL"
    },
    transcriber={
        "provider": "deepgram",
        "model": "nova-2:general",
        "language": "en-US"
    },
    initial_message={
        "mode": "fixed_message",
        "message": "Hello! How can I assist you today?",
        "delay_ms": 1000
    },
    max_duration_seconds=1800,
    tags=["support", "customer-service"]
)

print(f"Created agent: {agent.id}")

Installazione

pip install itellicoai
Visualizza la doc SDK Python →

Risorse