Collegare la vostra IA all'Assistente

Scegliere un fornitore di IA o il server della vostra organizzazione, trovare la chiave, capire costi e riservatezza.

L'Assistente è un connettore: Omnifloo non ospita né fornisce alcuna intelligenza artificiale. Voi portate il vostro fornitore (o il server di IA della vostra organizzazione) e la vostra chiave; l'Assistente inoltra le richieste e mostra le proposte.

Scegliere un fornitore

Scelta	Per chi
Mistral (UE), proposto per impostazione predefinita	Un fornitore europeo: comodo se tenete a un hosting nell'Unione europea.
OpenAI o Claude (Anthropic)	Se la vostra organizzazione ha già un account presso uno di loro.
Compatibile (il vostro server)	Il server di IA della vostra organizzazione, di un hosting europeo o un software libero installato da voi, purché accetti il formato di API «chat» più diffuso.

Il campo Modello è libero: digitate il nome esatto del modello del vostro fornitore o sceglietene uno dall'elenco dei suggerimenti.

Dove trovo la mia chiave?

Create un account presso il vostro fornitore e aprite la sua area sviluppatori (spesso chiamata «API», «Chiavi API» o «Console»).
Create una chiave e copiatela subito: di solito viene mostrata una sola volta.
In quell'area, se possibile, fissate un limite di spesa mensile.
Per un server interno, chiedete la chiave (o il token) all'amministratore di quel server.

Configurare l'Assistente

Aprite Impostazioni (ingranaggio) nell'Assistente, oppure la pagina office.omnifloo.com/assistant.
Scegliete il fornitore, incollate la chiave e indicate il modello se non volete quello proposto.
Fate clic su Verifica connessione, poi su Salva.

La chiave resta nel vostro browser: per impostazione predefinita solo per la sessione (cancellata alla chiusura della scheda). Selezionate Memorizza la chiave per conservarla su questo dispositivo; evitatelo su un computer condiviso.

Collegare il server della vostra organizzazione

Scegliete Compatibile (il vostro server).
Inserite l'indirizzo di base del vostro server, ad esempio https://ia.esempio.it/v1: l'Assistente aggiunge da solo /chat/completions.
Indicate la chiave (o il token) e il nome del modello di quel server.
Verifica connessione, poi Salva.

Per impostazione predefinita la richiesta passa dal relay Omnifloo, che accetta solo indirizzi https pubblici: un indirizzo interno (rete privata, localhost, metadati dell'hosting) viene rifiutato e i reindirizzamenti non vengono seguiti.

Server interno non raggiungibile da Internet: la chiamata diretta

Selezionate Chiamata diretta da questo browser. Testo e chiave vanno allora direttamente dal vostro browser al vostro server, senza passare da Omnifloo. A questo scopo il vostro server deve:

essere raggiungibile dal computer dell'utente (rete dell'organizzazione, VPN);
consentire l'origine della pagina tramite CORS: https://office.omnifloo.com (pagina web) e https://office-ds.omnifloo.com (editor), con le intestazioni Authorization e Content-Type e il metodo POST;
usare https (il browser accetta un server http solo su localhost).

Se la verifica fallisce con «Chiamata diretta impossibile», quasi sempre si tratta di CORS o dell'accesso di rete: rivolgetevi all'amministratore del server.

Riservatezza

Viene inviato solo il passaggio che voi selezionate, al fornitore che voi avete scelto, con la vostra chiave.
Omnifloo non conserva né il testo, né la chiave, né la risposta. In chiamata diretta nulla passa da Omnifloo.
Il vostro fornitore applica le proprie condizioni: leggetele prima di inviare dati personali o riservati. Per il massimo controllo, usate il server della vostra organizzazione.

Costi

L'uso è fatturato dal vostro fornitore (o a carico della vostra organizzazione per un server interno). Omnifloo non fattura alcuna IA e non ne include nelle sue offerte. Il numero di richieste è limitato in un breve periodo per proteggere il servizio.

Risoluzione dei problemi

Messaggio	Cosa controllare
«chiave API rifiutata»	Incollate di nuovo la chiave senza spazi; verificate che sia attiva presso il fornitore.
«modello non trovato»	Verificate il nome esatto del modello.
«quota o credito esauriti»	Ricaricate il credito o alzate il limite presso il fornitore.
«è accettato solo un indirizzo pubblico (https)»	Usate un indirizzo https pubblico, oppure selezionate la chiamata diretta per un server interno.
«Chiamata diretta impossibile»	Verificate l'accesso di rete e il CORS del vostro server.

Vedere anche Configurare l'Assistente di scrittura e Assistente: cosa viene inviato, dove e a chi.