Configurar un modelo personalizado en WorkBuddy

Esta guía utiliza la interfaz de modelo personalizada actual de WorkBuddy. Prepare una clave OmniaKey API y una identificación de modelo exacta antes de abrir WorkBuddy.

El formulario, los detalles del modelo guardado y el selector de modelo se verificaron en la aplicación macOS que ejecuta WorkBuddy v5.3.14. Las instrucciones oficiales de Tencent Cloud requieren al menos v4.22.15 para esta función.

Antes de empezar, prepara dos artículos.

Una clave OmniaKey API

Inicie sesión en OmniaKey y abra la página de claves API:

1. Seleccione Crear clave.
2. Nómbrelo WorkBuddy, luego establezca un límite y una caducidad adecuados.
3. Créelo y copie inmediatamente la nueva clave.

Mantenga abierto el cuadro de diálogo clave hasta que haya pegado la credencial en WorkBuddy. No coloques la clave en capturas de pantalla, mensajes de chat o archivos públicos.

La cuenta también necesita saldo disponible o crédito de prueba. Crear una clave solo crea una credencial; no garantiza que la cuenta pueda financiar una solicitud.

Una identificación de modelo exacta

Abra el Catálogo de modelos OmniaKey, elija un modelo disponible actualmente y copie el ID del modelo que se muestra en la página. Para una primera prueba, utilice:

deepseek-v4-flash

El ID debe coincidir exactamente. No ingrese el nombre para mostrar DeepSeek V4 Flash, elimine guiones ni invente un alias más corto.

Paso 1: Abra Agregar modelo

Inicie WorkBuddy y abra:

System Settings → Models → + Add model

En la página Modelos, seleccione + Agregar modelo en la esquina superior derecha.

También puedes ingresar desde la parte inferior de una nueva tarea:

Model picker → + Configure custom model

Si ninguna entrada está disponible, actualice WorkBuddy a la versión v4.22.15 o posterior. Las instrucciones actuales de Tencent Cloud requieren al menos esta versión para la interfaz.

Paso 2: Elija Personalizado y complete cuatro campos

Complete el formulario de arriba a abajo.

1. Elija el proveedor personalizado

Abra el menú Proveedor y seleccione:

Custom

En v5.3.14, aparece en el grupo Otro. No elija el OpenAI integrado, el Tencent Cloud Token Plan u otro proveedor porque esos perfiles no utilizan la dirección de interfaz OmniaKey.

2. Ingrese la dirección a través de /v1

En Dirección de interfaz o Base URL, ingrese exactamente:

https://api.omniakey.com/v1

3. Pegue la clave API

Pegue la clave que copió de OmniaKey en Clave API. No agregue comillas, espacios en blanco ni la palabra Bearer; introduzca sólo el valor clave.

4. Introduzca el nombre del modelo.

En Nombre del modelo o Model ID, ingrese el ID de catálogo exacto:

deepseek-v4-flash

El formulario principal ahora debería decir:

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

Para la primera prueba de conexión, deje los campos restantes con sus valores predeterminados y asegúrese de que Protocolo personalizado esté desactivado. En v5.3.14, un nuevo formulario comienza con Tool calling activado, entrada de imagen desactivada, modo de razonamiento desactivado, protocolo personalizado desactivado y límites de entrada y salida predeterminados del proveedor. A continuación aparece un ajuste preestablecido deepseek-v4-flash verificado.

Paso 3: Guarde, seleccione el modelo y pruébelo

Seleccione Guardar y regrese a una nueva tarea. Abra el selector de modelo en la parte inferior, busque la sección de modelo personalizado y elija deepseek-v4-flash.

Envía un breve mensaje de prueba:

Reply with exactly: Connection successful

Una respuesta normal confirma cuatro partes de la configuración a la vez:

1. WorkBuddy guardó el proveedor personalizado.
2. El Base URL es correcto.
3. La clave API se acepta y tiene crédito utilizable.
4. La clave puede acceder al ID del modelo seleccionado.

Finalmente, abra OmniaKey Usage y confirme que la llamada aparece con el modelo esperado. Esto cierra el ciclo de verificación de WorkBuddy a OmniaKey.

Si el modelo guardado no aparece inmediatamente, cierre y vuelva a abrir el selector. Salga por completo y reinicie WorkBuddy si aún no aparece.

Configuraciones avanzadas recomendadas para la primera prueba

No cambie varios controles de capacidad antes de que funcione el chat básico. Un nuevo modelo personalizado en WorkBuddy v5.3.14 comienza con:

Utilice estos valores predeterminados para verificar primero la URL, la clave y el nombre del modelo. Luego ajuste las capacidades del modelo.

Preestablecido deepseek-v4-flash verificado

El modelo guardado y las respuestas locales exitosas utilizaron esta configuración:

WorkBuddy muestra Solo razonamiento, Permitir deshabilitar el razonamiento y controles de esfuerzo después de habilitar el modo de razonamiento. Deje el esfuerzo en Auto para la primera prueba.

Cuándo habilitar la llamada a herramientas

Habilite Tool calling cuando WorkBuddy necesite leer archivos, usar conectores o realizar tareas de agente. El modelo también debe admitir llamadas de herramientas estructuradas. Actualmente, deepseek-v4-flash tiene soporte para herramientas en el catálogo OmniaKey, así que habilítelo después de que el chat básico funcione y comience con una tarea de solo lectura. Puede permanecer apagado para una prueba de chat sólo con conexión.

Cuándo habilitar la entrada de imágenes

Habilítelo solo para un modelo marcado explícitamente como que acepta imágenes. Un conmutador de cliente no puede agregar capacidad de visión a un modelo de solo texto.

Cuándo habilitar el modo de razonamiento

Habilítelo cuando el catálogo o la documentación del modelo incluya explícitamente el razonamiento, el pensamiento o un modo similar. Mantener el esfuerzo automático y permitir inhabilitar el razonamiento. No agregue valores de esfuerzo no admitidos y no establezca el modo de solo razonamiento como predeterminado para las tareas ordinarias.

Agregar otro modelo

No sobrescriba una entrada de modelo funcional. Abra Agregar modelo nuevamente, mantenga la misma URL OmniaKey y la misma clave API, reemplace solo el ID exacto del modelo y guárdelo como otro modelo personalizado.

Verifique un modelo antes de agregar el siguiente. Cuando aparece un problema, esto deja claro qué entrada guardada lo provocó.

Solución de problemas por síntoma

Falta configurar el modelo personalizado

Primero verifique la versión WorkBuddy. Actualice a v4.22.15 o posterior, luego busque en el selector de modelo de nueva tarea o en Configuración del sistema → Modelos.

HTTP 401, Clave API no autorizada o no válida

Copie la clave OmniaKey nuevamente. Verifique los espacios en blanco y asegúrese de no haber pegado Bearer con ellos. Confirme que la clave esté habilitada y vigente, y que tanto el saldo de la cuenta como el límite de la clave sean utilizables.

Cambiar la ID del modelo no soluciona un problema 401; la autenticación falló antes de que la selección del modelo importara.

HTTP 404 o punto final no encontrado

La dirección debe ser exactamente:

https://api.omniakey.com/v1

No utilice el dominio básico, no duplique /v1 ni agregue /chat/completions. También asegúrese de que Protocolo personalizado esté desactivado.

Modelo no encontrado o UNKNOWN_MODEL

Copie el ID nuevamente desde el catálogo de modelos en vivo. Un nombre para mostrar, un alias adivinado o una identificación retirada no son una identificación de modelo actual válida.

El chat funciona pero las herramientas fallan

La conexión del modelo básico ya está funcionando. Verifique el interruptor Tool calling del WorkBuddy y la capacidad de la herramienta del modelo. Volver a ingresar la clave o URL API no agregará compatibilidad con la herramienta.

La entrada de imagen falla

Ambas condiciones deben ser verdaderas: el modelo admite imágenes y el control de entrada de imágenes de WorkBuddy está habilitado.

El modelo falta después de guardar.

Confirme que seleccionó Guardar y luego vuelva a abrir el selector de modelo. Reinicie WorkBuddy si es necesario. Si la entrada de configuración en sí no está disponible, verifique la versión del cliente nuevamente.

Preguntas frecuentes

¿Qué URL OmniaKey debería usar WorkBuddy?

Utilice únicamente https://api.omniakey.com/v1. Es un Base URL; WorkBuddy agrega la ruta de operación.

¿Necesito un archivo models.json?

No. Esta guía sigue la interfaz actual Configurar modelo personalizado. Las instrucciones del archivo de configuración local más antiguas describen una ruta de instalación diferente.

¿Puedo configurar GPT, Claude, Gemini u otro modelo?

Sí, cuando el modelo figura actualmente en OmniaKey y admite la ruta compatible con OpenAI. Mantenga la misma URL y utilice el ID exacto del modelo de catálogo.

¿Está configurado MCP en este formulario?

No. Este formulario configura el modelo API. MCP y los conectores son configuraciones WorkBuddy independientes. Establezca un modelo de respuesta básico antes de agregar esas herramientas.

Referencias verificadas

• Tencent Cloud: configurar y usar WorkBuddy
• OmniaKey OpenAIReferencia de API compatible
• Catálogo de modelos en vivo OmniaKey