Configurare un modello personalizzato in WorkBuddy
Inserisci l'URL, la chiave API e il nome del modello nell'ordine mostrato, quindi verifica la connessione completa.
Questa guida utilizza l'attuale interfaccia del modello personalizzato di WorkBuddy. Preparare una chiave OmniaKey API e un ID modello esatto prima di aprire WorkBuddy.
Il modulo finito: scegli Personalizzato, inserisci https://api.omniakey.com/v1, incolla la chiave OmniaKey API e utilizza un ID modello esatto come deepseek-v4-flash.
Il modulo, i dettagli del modello salvato e il selettore del modello sono stati controllati nell'app macOS che esegue WorkBuddy v5.3.14. Le istruzioni ufficiali di Tencent Cloud richiedono almeno v4.22.15 per questa funzione.
| Campo WorkBuddy | Valore |
|---|---|
| Fornitore | Custom nel gruppo Altro |
| Indirizzo dell'interfaccia | https://api.omniakey.com/v1 |
| API Chiave | Una chiave creata in OmniaKey |
| Nome del modello | Ad esempio, deepseek-v4-flash |
Prima di iniziare, prepara due elementi
Una chiave OmniaKey API
Accedi a OmniaKey e apri la pagina Chiavi API:
- Seleziona Crea chiave.
- Chiamalo
WorkBuddy, quindi imposta un limite e una scadenza adeguati. - Crealo e copia immediatamente la nuova chiave.
Mantieni aperta la finestra di dialogo della chiave finché non avrai incollato le credenziali in WorkBuddy. Non inserire la chiave in screenshot, messaggi di chat o file pubblici.
L'account necessita inoltre di saldo disponibile o credito di prova. La creazione di una chiave crea solo una credenziale; non garantisce che l'account possa finanziare una richiesta.
Un ID modello esatto
Apri il Catalogo dei modelli OmniaKey, scegli un modello attualmente disponibile e copia l'ID del modello mostrato nella pagina. Per un primo test, utilizzare:
deepseek-v4-flash
L'ID deve corrispondere esattamente. Non inserire il nome visualizzato DeepSeek V4 Flash, rimuovere i trattini o inventare un alias più breve.
Passaggio 1: aprire Aggiungi modello
Avvia WorkBuddy e apri:
System Settings → Models → + Add model
Nella pagina Modelli, seleziona + Aggiungi modello nell'angolo in alto a destra.
Puoi anche inserire dalla parte inferiore di una nuova attività:
Model picker → + Configure custom model
Se nessuna delle due voci è disponibile, aggiorna WorkBuddy alla versione v4.22.15 o successiva. Le attuali istruzioni di Tencent Cloud richiedono almeno questa versione per l'interfaccia.
Passaggio 2: scegli Personalizzato e completa quattro campi
Compila il modulo dall'alto verso il basso.
1. Scegli il provider personalizzato
Apri il menu Fornitore e seleziona:
Custom
In v5.3.14, appare nel gruppo Altro. Non scegliere il OpenAI integrato, il piano token Tencent Cloud o un altro provider perché tali profili non utilizzano l'indirizzo dell'interfaccia OmniaKey.
2. Immettere l'indirizzo tramite /v1
In Indirizzo interfaccia o Base URL, inserisci esattamente:
https://api.omniakey.com/v1
Non copiare il segnaposto grigio. Mostra un esempio che termina con /v1/chat/completions, ma OmniaKey utilizza Base URL https://api.omniakey.com/v1 in questo campo.
3. Incolla la chiave API
Incolla la chiave che hai copiato da OmniaKey in Chiave API. Non aggiungere virgolette, spazi o la parola Bearer; immettere solo il valore della chiave.
4. Immettere il nome del modello
In Nome modello o Model ID, inserisci l'ID catalogo esatto:
deepseek-v4-flash
Il modulo principale ora dovrebbe essere:
Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash
Per il primo test di connessione, lascia i campi rimanenti ai valori predefiniti e assicurati che il Protocollo personalizzato sia disattivato. In v5.3.14, un nuovo modulo inizia con Tool calling attivato, Ingresso immagine disattivato, Modalità ragionamento disattivato, Protocollo personalizzato disattivato e limiti di input e output predefiniti dal provider. Di seguito viene visualizzata una preimpostazione deepseek-v4-flash verificata.
Passaggio 3: salva, seleziona il modello e testalo
Seleziona Salva e torna a una nuova attività. Apri il selettore modelli in basso, trova la sezione del modello personalizzato e scegli deepseek-v4-flash.
Invia un breve messaggio di prova:
Reply with exactly: Connection successful
Una risposta normale conferma quattro parti della configurazione contemporaneamente:
- WorkBuddy ha salvato il provider personalizzato.
- Il Base URL è corretto.
- La chiave API è accettata e ha credito utilizzabile.
- La chiave può accedere all'ID del modello selezionato.
Infine, apri OmniaKey Utilizzo e conferma che la chiamata venga visualizzata con il modello previsto. Questo chiude il ciclo di verifica da WorkBuddy a OmniaKey.
Se il modello salvato non viene visualizzato immediatamente, chiudi e riapri il selettore. Esci completamente e riavvia WorkBuddy se ancora non viene visualizzato.
Impostazioni avanzate consigliate per il primo test
Non modificare diversi controlli di funzionalità prima che la chat di base funzioni. Un nuovo modello personalizzato in WorkBuddy v5.3.14 inizia con:
| Opzione | Predefinito del nuovo formato |
|---|---|
| Tool calling | Su |
| Ingresso immagine | Spento |
| Modalità di ragionamento | Spento |
| Protocollo personalizzato | Spento |
| Limiti di ingresso e di uscita | Impostazioni predefinite del fornitore |
Utilizza queste impostazioni predefinite per verificare prima l'URL, la chiave e il nome del modello. Quindi modificare le capacità per il modello.
Preimpostazione deepseek-v4-flash verificata
Il modello salvato e le risposte locali riuscite hanno utilizzato questa configurazione:
| Opzione | Impostazione deepseek-v4-flash |
|---|---|
| Tool calling | Spento |
| Ingresso immagine | Spento |
| Modalità di ragionamento | Attivo |
| Solo ragionamento | Spento |
| Consenti ragionamento disabilitante | Attivo |
| Protocollo personalizzato | Spento |
| Sforzo di ragionamento predefinito | Auto (use request-layer default) |
| Sforzi di ragionamento supportati | Lascia deselezionati Basso, Medio, Alto, Molto alto e Massimo |
| Limiti di ingresso e di uscita | Impostazioni predefinite del fornitore |
WorkBuddy rivela solo Ragionamento, Consenti la disabilitazione del ragionamento e i controlli dello sforzo dopo l'attivazione della modalità Ragionamento. Lasciare lo sforzo su Auto per il primo test.
Quando abilitare la chiamata dello strumento
Abilita Tool calling quando WorkBuddy deve leggere file, utilizzare connettori o eseguire attività dell'agente. Il modello deve inoltre supportare chiamate di strumenti strutturati. deepseek-v4-flash attualmente dispone del supporto degli strumenti nel catalogo OmniaKey, quindi abilitalo dopo il funzionamento della chat di base e inizia con un'attività di sola lettura. Può rimanere disattivato per un test di chat di sola connessione.
Quando abilitare l'input di immagini
Abilitalo solo per un modello esplicitamente contrassegnato come accettante immagini. Uno switch client non può aggiungere funzionalità di visione a un modello di solo testo.
Quando abilitare la modalità di ragionamento
Abilitatelo quando il catalogo o la documentazione del modello elenca esplicitamente il ragionamento, il pensiero o una modalità simile. Mantieni lo sforzo automatico e Consenti la disabilitazione del ragionamento. Non aggiungere valori di impegno non supportati e non impostare la modalità di solo ragionamento come predefinita per le attività ordinarie.
Aggiunta di un altro modello
Non sovrascrivere una voce del modello funzionante. Apri nuovamente Aggiungi modello, mantieni lo stesso URL OmniaKey e la stessa chiave API, sostituisci solo l'ID modello esatto e salvalo come un altro modello personalizzato.
Verificare un modello prima di aggiungere il successivo. Quando si presenta un problema, viene chiarito quale voce salvata lo ha introdotto.
Risoluzione dei problemi in base al sintomo
Manca la configurazione del modello personalizzato
Controllare prima la versione WorkBuddy. Aggiorna a v4.22.15 o versione successiva, quindi cerca nel selettore del modello di nuova attività o in Impostazioni di sistema → Modelli.
HTTP 401, Chiave API non autorizzata o non valida
Copia nuovamente la chiave OmniaKey. Controlla la presenza di spazi bianchi e assicurati di non aver incollato Bearer. Conferma che la chiave sia abilitata e non scaduta e che sia il saldo dell'account che il limite della chiave siano utilizzabili.
La modifica dell'ID modello non risolve il problema 401; l'autenticazione non è riuscita prima che la selezione del modello diventasse importante.
HTTP 404 o endpoint non trovato
L'indirizzo deve essere esattamente:
https://api.omniakey.com/v1
Non utilizzare il dominio semplice, duplicare /v1 o aggiungere /chat/completions. Assicurati inoltre che il Protocollo personalizzato sia disattivato.
Modello non trovato o UNKNOWN_MODEL
Copia nuovamente l'ID dal catalogo dei modelli in tempo reale. Un nome visualizzato, un alias indovinato o un ID ritirato non è un ID modello corrente valido.
La chat funziona ma gli strumenti falliscono
La connessione del modello base è già funzionante. Controlla l'interruttore Tool calling di WorkBuddy e la capacità dello strumento del modello. Reinserire la chiave o l'URL API non aggiungerà il supporto dello strumento.
L'immissione dell'immagine non riesce
Entrambe le condizioni devono essere vere: il modello supporta le immagini e il controllo di input immagine di WorkBuddy è abilitato.
Il modello risulta mancante dopo il salvataggio
Conferma di aver selezionato Salva, quindi riapri il selettore modello. Riavviare WorkBuddy se necessario. Se la voce di configurazione stessa non è disponibile, controlla nuovamente la versione del client.
Domande frequenti
Quale URL OmniaKey dovrebbe utilizzare WorkBuddy?
Utilizzare solo https://api.omniakey.com/v1. È un Base URL; WorkBuddy aggiunge il percorso dell'operazione.
Ho bisogno di un file models.json?
No. Questa guida segue l'attuale interfaccia Configura modello personalizzato. Le istruzioni precedenti del file di configurazione locale descrivono un percorso di installazione diverso.
Posso configurare GPT, Claude, Gemini o un altro modello?
Sì, quando il modello è attualmente elencato in OmniaKey e supporta il percorso compatibile con OpenAI. Mantieni lo stesso URL e utilizza l'ID modello esatto del catalogo.
MCP è configurato su questo modulo?
No. Questo modulo configura il modello API. MCP e i connettori sono impostazioni WorkBuddy separate. Stabilire una risposta del modello di base prima di aggiungere tali strumenti.