Assistela Assistela Documentazione
Configurazione di Assistela

Il tuo fornitore LLM

Collega l’account del tuo fornitore LLM con una chiave API oppure accedi con un abbonamento ChatGPT.

Prima di iniziare

Per una connessione API servono un account presso il fornitore scelto e la relativa chiave API. Un abbonamento ChatGPT e l’API OpenAI sono servizi distinti: ChatGPT Plus, da solo, non crea una chiave API OpenAI né credito API.

Archiviazione sicura

Quando Assistela chiede dove conservare password e chiavi di accesso, per l’uso normale scegli Usa il portachiavi del Mac. I dati di Assistela sono più facili da includere in un backup, ma diventano più sensibili quando contengono chiavi.

OpenAI, Anthropic o un altro fornitore in elenco

1

Aggiungi un account IA

Apri Assistela → Impostazioni → Account IA. Fai clic su + in basso a sinistra e scegli il fornitore.

2

Controlla il server API

Per i fornitori in elenco, il campo Indirizzo del server API nella scheda Account è già compilato. Modificalo solo se il fornitore indica espressamente un indirizzo diverso.

3

Incolla la chiave API

In Chiave di accesso, incolla la chiave API esattamente come appare nel pannello del fornitore. Non aggiungere spazi o virgolette.

4

Salva e verifica

Fai clic su Salva e verifica account. Attendi il messaggio che indica che l’account è pronto o che la connessione funziona.

5

Seleziona un modello

Apri la scheda Modello. Mantieni il modello preimpostato oppure aggiorna l’elenco dei modelli e scegline un altro. Inserisci manualmente il nome di un modello solo se il fornitore non lo restituisce nell’elenco.

6

Impostalo come predefinito

Nella scheda Account, fai clic su Imposta come predefinito. Invia quindi un messaggio di prova nella Chat.

API personalizzata compatibile con OpenAI o Anthropic

Dal menu +, scegli Personalizzata compatibile con OpenAI o Personalizzata compatibile con Anthropic. Per un account personalizzato l’indirizzo del server non è compilato.

  • In Indirizzo del server API, inserisci l’URL completo indicato nella documentazione del fornitore. Un’API compatibile con OpenAI include spesso un percorso come /v1, ma fa fede la documentazione del fornitore specifico.
  • Conferma il formato di connessione corretto: formato API OpenAI o formato API Anthropic Messages.
  • Incolla la chiave API e fai clic su Salva e verifica account.
  • Nella scheda Modello, carica l’elenco dei modelli. Se l’API non fornisce un elenco, scegli un modello personalizzato e inserisci l’ID esatto del modello.

Abbonamento ChatGPT senza chiave API

1

Scegli Abbonamento ChatGPT

In Impostazioni → Account IA, fai clic su + e scegli Abbonamento ChatGPT.

2

Avvia la connessione

Fai clic su Collega ChatGPT. Assistela mostra un codice monouso.

3

Apri OpenAI

Usa Apri la pagina OpenAI e Copia codice. Nella pagina che si apre, accedi all’account ChatGPT corretto e inserisci il codice.

4

Attendi la conferma

Torna ad Assistela e lascia aperta la finestra. L’app verifica automaticamente la connessione per diversi minuti. Se compare un pulsante per confermare l’inserimento del codice, usalo.

5

Impostalo come predefinito

Quando la connessione riesce, fai clic su Imposta come predefinito e prova la Chat.

Problemi comuni

  • Chiave non valida: crea o copia di nuovo la chiave API, quindi salva nuovamente l’account.
  • Indirizzo del server API non valido: confronta https://, il percorso dell’API e l’eventuale /v1 finale con la documentazione del fornitore.
  • Modello non trovato: aggiorna l’elenco dei modelli o inserisci l’ID esatto del modello.
  • L’account funziona ma la Chat non lo usa: imposta l’account come predefinito e verifica che sia attivo.

Scegliere un modello senza regolazioni complesse

Per l’account principale, inizia con un modello che il fornitore dichiara compatibile con il tool calling. Se la Chat risponde ma non riesce a usare Calendario, email o altre azioni, verifica il supporto degli strumenti prima di cambiare le impostazioni avanzate dei token.

  • Usa come predefinito un modello generale capace per la Chat e i lavori complessi.
  • Un modello più rapido ed economico può essere adatto a controlli automatici semplici e frequenti.
  • Dopo aver cambiato modello, usa Salva e verifica account, quindi prova un’azione sicura in sola lettura.

Consulta Instradamento dei modelli per distribuire il lavoro tra più modelli.