Configurare un provider

L'assistente AI è disattivato finché non aggiungi una connessione. Apri Strumenti → Impostazioni → AI, oppure clicca Vai alle impostazioni AI dal pannello dell'assistente.

Puoi configurare più connessioni AI e sceglierne una per ogni richiesta.

Campi

Campo	Significato
Nome connessione	Come appare nel selettore
API URL	L'URL base del provider
Tipo di API	openai, anthropic o gemini — determina il formato della richiesta
Nome utente (Basic Auth)	Facoltativo, per gateway che richiedono autenticazione basic
Chiave API / Token	La tua chiave
Modello	L'identificatore del modello
System prompt	Istruzioni anteposte a ogni richiesta
Invia schema tabelle	Include la struttura delle tabelle selezionate
Invia campione dati (TOP 5)	Include fino a 5 righe da ogni tabella selezionata

Provider

Compatibili con OpenAI

Tipo di API: openai
API URL:     https://api.openai.com/v1

La richiesta va a {URL}/chat/completions con un token Bearer.

Anthropic

Tipo di API: anthropic
API URL:     https://api.anthropic.com/v1

La richiesta va a {URL}/messages con l'header x-api-key e versione API 2023-06-01. Le risposte sono limitate a 4096 token.

Google Gemini

Tipo di API: gemini
API URL:     https://generativelanguage.googleapis.com/v1beta

La chiave viene passata come parametro dell'URL e il system prompt come systemInstruction.

Modelli locali

Funziona qualsiasi server che parli l'API chat di OpenAI — imposta Tipo di API su openai e punta l'URL su di esso. Per Ollama:

Tipo di API: openai
API URL:     http://localhost:11434/v1
Modello:     llama3.1        # o quello che hai scaricato
Chiave API:  ollama          # il campo la richiede, il server la ignora

Lo stesso vale per LM Studio, vLLM, il server di llama.cpp e simili. In questa configurazione nulla lascia la tua macchina — che è il punto, se il tuo schema è riservato.

Cosa viene inviato

Leggi prima di attivare schema e campioni

• Invia schema tabelle trasmette nomi di tabelle e colonne e i loro tipi.
• Invia campione dati (TOP 5) trasmette righe reali del tuo database — fino a cinque per tabella selezionata, dati personali inclusi.

Entrambi sono disattivati finché non li attivi e valgono solo per le tabelle che scegli per una data domanda. Con un provider cloud quei dati lasciano la tua macchina e sono soggetti alle condizioni di quel provider. Con un modello locale non lasciano affatto la macchina.

Anteprima richiesta, nel pannello dell'assistente, mostra il JSON esatto prima dell'invio. Nel dubbio, guarda.

Verificare che funzioni

Apri un editor SQL, clicca AI, scegli la connessione, chiedi qualcosa di semplice come «seleziona le dieci righe più recenti da utenti» e invia. Un errore di autenticazione o di nome del modello torna testualmente dal provider e di solito dice esattamente cosa non va.