WorkBuddy

O WorkBuddy pode ligar-se à HiAPI através de um modelo personalizado. Só suporta o protocolo OpenAI Chat Completions (chamado OpenAI-compatible na interface), por isso os modelos que só suportam Anthropic Messages não podem ser ligados. Os passos abaixo usam gpt-6-astra como exemplo; este tutorial foi verificado no WorkBuddy 5.8.3. Para usar outro modelo, encontre o nome na lista de modelos de texto e introduza-o; se o teste de ligação for rejeitado, o modelo não suporta Chat Completions, por isso mude para outro.

1. Preparar uma HiAPI API key

Prepare uma chave como descrito em Obter uma chave de API, clique no ícone de copiar junto à chave e copie a HiAPI API key completa para preencher no WorkBuddy abaixo.

2. Adicionar um modelo

2.1 Abrir a entrada

Clique em Settings → Models → Add Model (设置 → 模型 → 添加模型).

2.2 Preencher os campos

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

Preencha o endereço da API apenas até /v1; não acrescente /chat/completions nem /responses. O suporte de parâmetros varia consoante o modelo; consulte a página do modelo.

Clique em Test connection (测试连接) e guarde quando passar.

3. Verificar

3.1 Conversa

Envie «Olá, apresente-se numa frase.». Uma resposta normal significa que a ligação funciona.

3.2 Chamadas de ferramentas

Primeiro crie tool-call-test.txt na pasta de trabalho que o WorkBuddy está a usar, escreva uma linha hello hiapi e guarde. Depois envie «Tem de chamar uma ferramenta. Leia todo o conteúdo de tool-call-test.txt e devolva-o exatamente como está. Não adivinhe o conteúdo pelo nome do ficheiro.». Aparece uma chamada de ferramenta e devolve hello hiapi, por isso passa.

Esta página só abrange modelos de texto; para capacidades de ferramentas, consulte o guia do MCP.

4. Resolução de problemas

Aqui só estão listados problemas específicos do WorkBuddy. Para erros comuns como 401, 404 e 429, consulte Erros comuns.

Quando o Test connection (测试连接) do WorkBuddy encontra um erro de protocolo, só devolve uma mensagem genérica sem o motivo específico, por isso use a tabela abaixo para o restringir:

Erro	Causa	Resolução
O serviço do modelo rejeitou o pedido de teste	O modelo não suporta OpenAI Chat Completions	Mude para um modelo que suporte Chat Completions
O endereço da API ou o nome do modelo está incorreto	O endereço da API está errado	Defina o endereço da API como https://api.hiapi.ai/v1
401	A HiAPI API key está errada	Cole-a novamente, sem espaços antes ou depois
Invalid model name	O nome do modelo está mal escrito	Introduza o nome do modelo exatamente como aparece na lista de modelos de texto