WorkBuddy

WorkBuddy puede conectarse a HiAPI mediante un modelo personalizado. Solo admite el protocolo OpenAI Chat Completions (llamado OpenAI-compatible en la interfaz), así que los modelos que solo admiten Anthropic Messages no se pueden conectar. Los pasos siguientes usan gpt-6-astra como ejemplo; este tutorial se verificó en WorkBuddy 5.8.3. Para usar otro modelo, busca su nombre en la lista de modelos de texto e introdúcelo; si la prueba de conexión lo rechaza, el modelo no admite Chat Completions, así que cambia a otro.

1. Prepara una HiAPI API key

Prepara una clave como se describe en Obtener una API key, haz clic en el icono de copiar junto a la clave y copia la HiAPI API key completa para rellenarla en WorkBuddy más abajo.

2. Añade un modelo

2.1 Abre la entrada

Haz clic en Settings → Models → Add Model (设置 → 模型 → 添加模型).

2.2 Rellena los campos

Campo	Valor
Supplier (供应商)	Custom (自定义)
API address (接口地址)	https://api.hiapi.ai/v1
API Key	tu HiAPI API key
Model name (模型名称)	gpt-6-astra
Advanced settings → Tool calling (高级配置 → 工具调用)	Márcalo
Input / Output (输入 / 输出)	Mantén “Use provider default” (使用提供商默认值)

Rellena la API address solo hasta /v1; no añadas /chat/completions ni /responses. La compatibilidad de parámetros varía según el modelo; consulta la página del modelo.

Haz clic en Test connection (测试连接) y guarda cuando pase.

3. Verificar

3.1 Chat

Envía “Hola, preséntate en una frase.” Una respuesta normal significa que la conexión funciona.

3.2 Llamadas a herramientas

Primero crea tool-call-test.txt en la carpeta de trabajo que WorkBuddy esté usando ahora, escribe una línea hello hiapi y guárdalo. Luego envía “Debes llamar a una herramienta. Lee todo el contenido de tool-call-test.txt y devuélvelo exactamente tal cual. No adivines el contenido a partir del nombre del archivo.” Aparece una llamada a herramienta que devuelve hello hiapi, así que pasa.

Esta página solo cubre los modelos de texto; para las capacidades de herramientas consulta la guía de MCP.

4. Solución de problemas

Aquí solo se recogen los problemas propios de WorkBuddy. Para errores comunes como 401, 404 y 429, consulta Errores comunes.

Cuando Test connection (测试连接) de WorkBuddy se topa con un error de protocolo, solo devuelve un mensaje genérico sin el motivo concreto, así que usa la tabla siguiente para acotarlo:

Error	Causa	Solución
El servicio del modelo rechazó la solicitud de prueba	El modelo no admite OpenAI Chat Completions	Cambia a un modelo que admita Chat Completions
La dirección de API o el nombre del modelo son incorrectos	La API address es incorrecta	Define la API address como https://api.hiapi.ai/v1
401	La HiAPI API key es incorrecta	Vuelve a pegarla, sin espacios delante ni detrás
Invalid model name	El nombre del modelo está mal escrito	Introduce el nombre del modelo exactamente como aparece en la lista de modelos de texto