Costruisci sul tuo box
IntelligenceBox espone un’API HTTP per tutto quello che sa fare: cercare nei tuoi documenti, eseguire assistenti, gestire le cartelle di conoscenza e inviare notifiche direttamente all’app desktop. Una API key, un indirizzo, nessun SDK da installare.
Come si incastrano i pezzi#
Quattro oggetti coprono quasi tutto quello che costruirai.
Partenza rapida#
Da zero a una risposta in streaming in tre passi.
- 1
Genera una API key
Nell’app desktop apri Impostazioni → Sistema → API key, dai un’etichetta e genera la chiave. Inizia con
Guida completa all’autenticazione →key-. - 2
Trova l’indirizzo del tuo box
Ogni box ha il proprio indirizzo, che trovi in Impostazioni → Informazioni dispositivo. In rete locale somiglia a
http://192.168.1.100oppurehttp://intelligencebox.local; con l’accesso remoto attivo è un sottodominiohttps://…intelligencebox.it.In tutti gli esempi lo scriviamo come
BOX_URL. - 3
Fai la prima chiamata
Verifica che la chiave funzioni, poi invia un messaggio. L’endpoint di chat restituisce la risposta come Server-Sent Events.
# Chi sono? — verifica la chiave e il workspace
curl BOX_URL/api/public/me \
-H "x-api-key: YOUR_API_KEY"
# Fai una domanda (risposta in streaming)
curl -N -X POST BOX_URL/api/ai/chat \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "my-first-chat",
"messages": [{ "role": "user", "content": "Hello!" }],
"boxAddress": "BOX_URL"
}'Preferisci l’SDK di OpenAI?
Il box parla anche il formato OpenAI su/api/v1/chat/completions. Punta un qualsiasi client compatibile su BOX_URL/api/v1 con la tua API key e funziona senza modifiche — vedi il riferimento della chat.Da dove continuare#
Le tre pagine che rispondono alla maggior parte delle prime domande.