Configurer un modèle personnalisé dans WorkBuddy

Ce guide utilise l'interface de modèle personnalisé actuelle de WorkBuddy. Préparez une clé OmniaKey API et un identifiant de modèle exact avant d'ouvrir le WorkBuddy.

Le formulaire, les détails du modèle enregistrés et le sélecteur de modèle ont été vérifiés dans l'application macOS exécutant WorkBuddy v5.3.14. Les instructions officielles de Tencent Cloud nécessitent au moins v4.22.15 pour cette fonctionnalité.

Avant de commencer, préparez deux éléments

Une clé OmniaKey API

Connectez-vous à OmniaKey et ouvrez la Page Clés API :

1. Sélectionnez Créer une clé.
2. Nommez-le WorkBuddy, puis définissez une limite et une expiration appropriées.
3. Créez-le et copiez immédiatement la nouvelle clé.

Gardez la boîte de dialogue de clé ouverte jusqu'à ce que vous ayez collé les informations d'identification dans WorkBuddy. Ne placez pas la clé dans des captures d'écran, des messages de discussion ou des fichiers publics.

Le compte a également besoin d'un solde disponible ou d'un crédit d'essai. La création d'une clé crée uniquement un identifiant ; cela ne garantit pas que le compte puisse financer une demande.

Un identifiant de modèle exact

Ouvrez le Catalogue de modèles OmniaKey, choisissez un modèle actuellement disponible et copiez l'ID de modèle affiché sur la page. Pour un premier test, utilisez :

deepseek-v4-flash

L'identifiant doit correspondre exactement. N'entrez pas le nom d'affichage DeepSeek V4 Flash, ne supprimez pas les traits d'union et n'inventez pas un alias plus court.

Étape 1 : Ouvrir Ajouter un modèle

Démarrez WorkBuddy et ouvrez :

System Settings → Models → + Add model

Sur la page Modèles, sélectionnez + Ajouter un modèle dans le coin supérieur droit.

Vous pouvez également saisir par le bas une nouvelle tâche :

Model picker → + Configure custom model

Si aucune des deux entrées n'est disponible, mettez à jour WorkBuddy vers la version v4.22.15 ou une version ultérieure. Les instructions actuelles de Tencent Cloud nécessitent au moins cette version pour l'interface.

Étape 2 : choisissez Personnalisé et remplissez quatre champs

Remplissez le formulaire de haut en bas.

1. Choisissez le fournisseur personnalisé

Ouvrez le menu Fournisseur et sélectionnez :

Custom

Dans v5.3.14, il apparaît sous le groupe Autre. Ne choisissez pas le OpenAI intégré, le Tencent Cloud Token Plan ou un autre fournisseur, car ces profils n'utilisent pas l'adresse d'interface OmniaKey.

2. Entrez l'adresse via /v1

Dans Adresse d'interface ou Base URL, saisissez exactement :

https://api.omniakey.com/v1

3. Collez la clé API

Collez la clé que vous avez copiée de OmniaKey dans API Key. N'ajoutez pas de guillemets, d'espaces ou le mot Bearer ; entrez uniquement la valeur clé.

4. Entrez le nom du modèle

Sous Nom du modèle ou Model ID, saisissez l'ID de catalogue exact :

deepseek-v4-flash

Le formulaire principal devrait maintenant se lire :

Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash

Pour le premier test de connexion, laissez les champs restants avec leurs valeurs par défaut et assurez-vous que Protocole personnalisé est désactivé. Dans v5.3.14, un nouveau formulaire commence par Tool calling activé, la saisie d'image désactivée, le mode de raisonnement désactivé, le protocole personnalisé désactivé et les limites d'entrée et de sortie par défaut du fournisseur. Un préréglage deepseek-v4-flash vérifié apparaît ci-dessous.

Étape 3 : Enregistrez, sélectionnez le modèle et testez-le

Sélectionnez Enregistrer et revenez à une nouvelle tâche. Ouvrez le sélecteur de modèle en bas, recherchez la section modèle personnalisé et choisissez deepseek-v4-flash.

Envoyez un court message de test :

Reply with exactly: Connection successful

Une réponse normale confirme quatre parties de la configuration à la fois :

1. WorkBuddy a enregistré le fournisseur personnalisé.
2. Le Base URL est correct.
3. La clé API est acceptée et dispose d'un crédit utilisable.
4. La clé peut accéder à l'ID du modèle sélectionné.

Enfin, ouvrez OmniaKey Usage et confirmez que l'appel apparaît avec le modèle attendu. Cela ferme la boucle de vérification de WorkBuddy à OmniaKey.

Si le modèle enregistré n'apparaît pas immédiatement, fermez et rouvrez le sélecteur. Quittez complètement et redémarrez WorkBuddy s'il n'apparaît toujours pas.

Paramètres avancés recommandés pour le premier test

Ne modifiez pas plusieurs contrôles de fonctionnalités avant que le chat de base ne fonctionne. Un nouveau modèle personnalisé dans WorkBuddy v5.3.14 commence par :

Utilisez ces valeurs par défaut pour vérifier d'abord l'URL, la clé et le nom du modèle. Ajustez ensuite les capacités du modèle.

Préréglage deepseek-v4-flash vérifié

Le modèle enregistré et les réponses locales réussies utilisaient cette configuration :

WorkBuddy révèle le raisonnement uniquement, autorise la désactivation du raisonnement et les contrôles d'effort une fois le mode raisonnement activé. Laissez l'effort sur Auto pour le premier test.

Quand activer l’appel d’outil

Activez Tool calling lorsque WorkBuddy doit lire des fichiers, utiliser des connecteurs ou effectuer des tâches d'agent. Le modèle doit également prendre en charge les appels d'outils structurés. deepseek-v4-flash dispose actuellement d'un support d'outils dans le catalogue OmniaKey, alors activez-le après les travaux de discussion de base et commencez par une tâche en lecture seule. Il peut rester désactivé pendant un test de chat en connexion uniquement.

Quand activer la saisie d’images

Activez-le uniquement pour un modèle explicitement marqué comme acceptant des images. Un commutateur client ne peut pas ajouter de fonctionnalité de vision à un modèle texte uniquement.

Quand activer le mode raisonnement

Activez-le lorsque le catalogue ou la documentation du modèle répertorie explicitement le raisonnement, la réflexion ou un mode similaire. Conserver l'effort automatique et autoriser le raisonnement invalidant. N'ajoutez pas de valeurs d'effort non prises en charge et ne faites pas du mode raisonnement uniquement le mode par défaut pour les tâches ordinaires.

Ajout d'un autre modèle

N'écrasez pas une entrée de modèle de travail. Ouvrez à nouveau Ajouter un modèle, conservez la même URL OmniaKey et la même clé API, remplacez uniquement l'ID de modèle exact et enregistrez-le en tant qu'autre modèle personnalisé.

Vérifiez un modèle avant d’ajouter le suivant. Lorsqu'un problème apparaît, cela indique clairement quelle entrée enregistrée l'a introduit.

Dépannage par symptôme

Configurer le modèle personnalisé est manquant

Vérifiez d'abord la version WorkBuddy. Mettez à jour vers v4.22.15 ou une version ultérieure, puis recherchez dans le sélecteur de modèle de nouvelle tâche ou sous Paramètres système → Modèles.

HTTP 401, Clé API non autorisée ou invalide

Copiez à nouveau la clé OmniaKey. Vérifiez les espaces et assurez-vous de ne pas avoir collé Bearer avec. Confirmez que la clé est activée et n'a pas expiré, et que le solde du compte et la limite de clé sont utilisables.

La modification de l'ID de modèle ne corrige pas un 401 ; l'authentification a échoué avant que la sélection du modèle ne soit importante.

HTTP 404 ou point de terminaison introuvable

L'adresse doit être exactement :

https://api.omniakey.com/v1

N'utilisez pas le domaine nu, ne dupliquez pas /v1 ou n'ajoutez pas /chat/completions. Assurez-vous également que le Protocole personnalisé est désactivé.

Modèle introuvable ou UNKNOWN_MODEL

Copiez à nouveau l'ID à partir du catalogue de modèles dynamiques. Un nom d’affichage, un alias deviné ou un identifiant retiré n’est pas un identifiant de modèle actuel valide.

Le chat fonctionne mais les outils échouent

La connexion du modèle de base fonctionne déjà. VérifierWorkBuddyc'estTool callingcommutateur et la capacité de l'outil du modèle. Rentrer dans leAPIla clé ou l’URL n’ajoutera pas la prise en charge de l’outil.

La saisie de l'image échoue

Les deux conditions doivent être vraies : le modèle prend en charge les images et le contrôle d'entrée d'image de WorkBuddy est activé.

Le modèle est manquant après l'enregistrement

Confirmez que vous avez sélectionné Enregistrer, puis rouvrez le sélecteur de modèle. Redémarrez WorkBuddy si nécessaire. Si l'entrée de configuration elle-même n'est pas disponible, vérifiez à nouveau la version du client.

Questions fréquemment posées

Quelle URL OmniaKey WorkBuddy doit-elle utiliser ?

Utilisez uniquement https://api.omniakey.com/v1. Il s'agit d'un Base URL ; WorkBuddy ajoute le chemin d’accès à l’opération.

Ai-je besoin d’un fichier models.json ?

Non. Ce guide suit l'interface Configurer le modèle personnalisé actuelle. Les anciennes instructions du fichier de configuration local décrivent un chemin d’installation différent.

Puis-je configurer GPT, Claude, Gemini ou un autre modèle ?

Oui, lorsque le modèle est actuellement répertorié dans OmniaKey et prend en charge l'itinéraire compatible OpenAI. Conservez la même URL et utilisez l’ID exact du modèle de catalogue.

MCP est-il configuré sur ce formulaire ?

Non. Ce formulaire configure le modèle API. MCP et les connecteurs sont des paramètres WorkBuddy distincts. Établissez une réponse de modèle de base avant d’ajouter ces outils.

Références vérifiées

• Tencent Cloud : configurer et utiliser WorkBuddy
• Référence OmniaKey OpenAI compatible API
• Catalogue de modèles dynamiques OmniaKey