Chiavi AI e API
Ogni funzione AI e di contenuti stock dell'editor funziona con chiavi che fornisci tu. Questa pagina spiega dove inserirle: il provider AI usato dall'assistente chat, i cinque provider di media stock usati dalla scheda Media e la knowledge base opzionale con ricerca vettoriale alla base delle ricette di design dell'assistente.
Panoramica rapida
- Apri Settings, poi AI Settings.
- Scegli la scheda di un provider, incolla la tua chiave API e scegli un modello.
- Imposta un system prompt, una temperatura e un numero massimo di token facoltativi in General Settings, poi Save Settings.
- Usa Test Connection per verificare che la chiave funzioni prima di affidartici.
- Passa alla sezione Knowledge Base, o scorri fino a Stock Media API Keys, per gli altri due gruppi di chiavi.
Riferimento dettagliato
Provider AI
| Provider | Note |
|---|---|
| Qwen (DashScope) | Il provider predefinito |
| Kimi (Moonshot) | |
| DeepSeek | |
| GLM (Zhipu) | |
| OpenAI | |
| Google Gemini | |
| Anthropic Claude | |
| Endpoint personalizzato | Qualsiasi API di chat completion compatibile con OpenAI |
Ogni scheda mostra un campo per la chiave API mascherato come password con un interruttore mostra/nascondi, e un selettore di modelli sotto forma di griglia di schede. La scheda Custom Endpoint sostituisce la griglia dei modelli con i campi Base URL e Model Name, dato che non c'è un elenco fisso di modelli da scegliere. Vedi Assistente chat AI per sapere quali provider supportano la visione e la generazione nativa di immagini.
Impostazioni generali
Condivise da tutti i provider.
| Impostazione | Intervallo | Note |
|---|---|---|
| System prompt | Testo libero | Istruzioni personalizzate facoltative, ad esempio per orientare l'assistente verso un particolare stile di design |
| Temperature | Da 0 a 2 | Etichettata come Precise, Balanced, Creative o Wild mentre sposti il cursore |
| Max tokens | Da 100 a 32768 | Limita la lunghezza massima di una singola risposta |
Save Settings memorizza il provider attivo, la chiave e il modello; Test Connection invia una piccola richiesta per confermare che la chiave sia valida senza aspettare una chat reale.
Stock Media API Keys
Un elenco separato di chiavi che alimentano la ricerca all'interno della libreria multimediale, indipendente dalla chiave dell'assistente chat.
| Provider | Usato per | Registrazione | Note |
|---|---|---|---|
| Unsplash | Ricerca di immagini | unsplash.com/oauth/applications | Usa una Access Key, non la Secret Key; circa 50 richieste/ora su un'app demo non revisionata, molto più alte una volta che la tua app è approvata per la produzione |
| Pexels | Ricerca di immagini e video | pexels.com/api | La chiave viene rilasciata subito dopo la richiesta |
| Pixabay | Ricerca di immagini, video e audio | pixabay.com/api/docs | Una sola chiave copre tutti e tre i tipi di media, con un limite al minuto anziché al giorno |
| Freesound | Ricerca di audio | freesound.org/apiv2/apply | Inviata nella richiesta come token, non come valore grezzo della chiave |
| Jamendo | Ricerca di audio | devportal.jamendo.com | Gratuita per uso non commerciale |
| GIPHY | GIF e sticker | developers.giphy.com | Usata anche dal pannello Emoji, GIF e sticker |
Ogni campo ha un interruttore Show/Hide e istruzioni di registrazione inline. Un'azione Test Keys verifica tutte le chiavi configurate in una volta sola e riporta un esito positivo/negativo per ciascun provider, incluso il codice di stato HTTP in caso di errore, così una chiave errata o scaduta è facile da distinguere da un provider semplicemente non raggiungibile.
Knowledge Base
Un database vettoriale Qdrant opzionale che alimenta la ricerca semantica dell'assistente sulle ricette di design integrate. Senza di esso, l'assistente ricade su una corrispondenza locale per parole chiave, che funziona comunque ma è meno precisa.
| Campo | Scopo |
|---|---|
| Qdrant URL | Il tuo endpoint Qdrant Cloud (o self-hosted) |
| Qdrant API key | Autentica verso quell'endpoint |
| Embedding provider | OpenAI, Qwen, Google o GLM |
| Embedding model | Dipende dal provider scelto |
| Embedding API key | Facoltativa; lasciala vuota per riusare la chiave del provider AI della chat |
Save & Enable attiva la ricerca Qdrant, Seed Qdrant vi carica il set di ricette integrate e Disable Qdrant ripristina la ricerca locale senza perdere i dettagli della connessione.
Skills Manager
Il pulsante Customize / Skills in cima ad AI Settings apre l'editor delle skill, dove crei e assegni le skill AI, profili di istruzioni personalizzate attivati con un comando slash. Vedi Skill AI per capire come costruirle e usarle.
Una skill è strutturata come una piccola cartella: un'istruzione principale SKILL.md più un insieme facoltativo di documenti di reference, ciascuno con il proprio titolo e contenuto, a cui la skill può attingere.
| Elemento | Dettaglio |
|---|---|
| Skill integrate | Fornite con l'editor; il loro nome, descrizione e SKILL.md sono in sola lettura, ma puoi comunque assegnarle ai provider |
| My Skills | Tutto ciò che crei tu; completamente modificabile, inclusi SKILL.md, reference, icona e descrizione |
| Assegnazione ai provider | Una griglia di caselle di controllo ti permette di attivare una skill per uno o più provider in modo indipendente, così provider diversi possono eseguire skill diverse |
| Comando slash | Il nome di ogni skill viene trasformato in uno slug come comando di chat (mostrato in tempo reale mentre modifichi il nome), ad esempio una skill chiamata "Brand Voice" diventa /brand-voice |
| Duplicate | Funziona sia sulle skill integrate sia su quelle personalizzate; duplicare una skill integrata è il modo per iniziare a modificarla, dato che l'originale resta bloccato |
Dettagli di connessione della Knowledge Base
La sezione Knowledge Base (una voce della barra laterale separata da AI Settings) è dove si inseriscono e salvano l'URL Qdrant, la chiave e l'embedding provider della tabella qui sopra; Save & Enable, Seed Qdrant e Disable Qdrant si trovano tutti in quella sezione.
Passo dopo passo
Collegare una chiave di un provider AI dall'inizio alla fine
- Apri Settings, poi AI Settings.
- Fai clic sulla scheda di un provider (ad esempio Qwen, DeepSeek o Anthropic Claude).
- Incolla la tua chiave nel campo API Key, usando l'interruttore mostra/nascondi per ricontrollarla, poi scegli un modello dalla griglia di schede (oppure, in Custom Endpoint, compila invece Base URL e Model Name).
- Facoltativamente imposta un system prompt, una temperatura e un numero massimo di token in General Settings.
- Fai clic su Save Settings, poi su Test Connection per confermare che la chiave funzioni davvero prima di affidartici in una chat.
Configurare una chiave di media stock e verificarla
- Scorri fino a Stock Media API Keys, più in basso in AI Settings.
- Registrati sul sito del provider elencato sopra e copia la chiave che rilascia.
- Incollala nel campo corrispondente e fai clic su Save API Keys.
- Fai clic su Test Keys; ogni provider configurato riporta OK o uno specifico errore HTTP inline, così sai subito se una chiave va corretta.
Costruire una skill AI personalizzata e attivarla
- Fai clic su Customize / Skills in cima ad AI Settings.
- Fai clic su New Skill, dalle un nome e una descrizione, e scegli un'icona.
- Scrivi le tue istruzioni nell'editor SKILL.md; aggiungi uno o più documenti di reference dall'albero dei file se la skill ha bisogno di materiale di supporto oltre all'istruzione principale.
- Seleziona i provider su cui vuoi renderla disponibile nella griglia Provider Assignment, poi salva.
- Nella chat AI, digita il comando slash della skill (mostrato nell'anteprima sotto l'editor) per attivarla.
Attivare la knowledge base Qdrant
- Apri Settings, poi Knowledge Base.
- Inserisci il tuo URL Qdrant e la chiave API, scegli un embedding provider e un modello, e facoltativamente una chiave API di embedding separata (lasciala vuota per riusare la chiave del provider AI della chat).
- Fai clic su Save & Enable, poi su Seed Qdrant per caricarvi il set di ricette integrate.
- Se vuoi tornare alla corrispondenza locale per parole chiave, fai clic su Disable Qdrant; i dettagli della connessione vengono conservati, quindi riattivarla in seguito non richiede di reinserirli.
Attività comuni
| Attività | Passaggi |
|---|---|
| Cambiare il provider attivo senza perdere le altre chiavi | Fai clic su una scheda di provider diversa e salva; la chiave di ogni provider è memorizzata in modo indipendente |
| Assegnare una skill solo al tuo provider più veloce | Deselezionala per ogni altro provider nella griglia Provider Assignment di quella skill |
| Iniziare a modificare una skill integrata | Aprila, fai clic su Duplicate, poi modifica la copia in My Skills |
| Confermare che un Custom Endpoint funzioni davvero | Non c'è un elenco di modelli con cui fare un controllo, quindi invia un messaggio di chat reale dopo aver salvato anziché affidarti solo a Test Connection |
| Liberare una connessione della knowledge base senza perdere le ricette caricate | Usa Disable Qdrant invece di svuotare i campi URL e chiave |
Risoluzione dei problemi
Una chiave mancante mostra un avviso, non un errore silenzioso
Sia i pannelli di ricerca stock sia il pannello di GIF/sticker mostrano un messaggio esplicito "aggiungi la tua chiave" che rimanda alle impostazioni quando manca una chiave necessaria, anziché restituire risultati vuoti.
Test Keys riporta lo stato HTTP per ciascun provider
Un test fallito mostra il codice di stato HTTP effettivo restituito da quel provider (ad esempio un 401 per una chiave errata rispetto a un 429 per il rate limiting), così puoi distinguere un errore di battitura da un'interruzione temporanea del provider.
Le skill integrate non si possono modificare o eliminare direttamente
I loro campi nome, descrizione e SKILL.md sono in sola lettura e non c'è un pulsante di eliminazione. Duplica prima una skill integrata per ottenere una copia modificabile ed eliminabile in My Skills.
Suggerimenti
Tieni separate le chiavi della chat e quelle stock
La chiave del provider AI guida la conversazione e la generazione; le chiavi dei media stock alimentano solo la ricerca nella scheda Media. Impostare una non configura l'altra.
Testa prima di affidartici
Le API dei provider cambiano nel tempo i formati delle chiavi e i limiti di frequenza. Esegui Test Connection o Test Keys dopo aver incollato una chiave, invece di scoprire un errore di battitura a metà lavoro.
Correlati
- Assistente chat AI per ciò che supporta ciascun provider
- Skill AI per costruire e attivare skill personalizzate
- Libreria multimediale e contenuti stock per ciò che le chiavi stock sbloccano
- Impostazioni dell'editor per il resto della schermata delle impostazioni