Configurar um modelo personalizado no WorkBuddy

Este guia usa a interface de modelo personalizado atual do WorkBuddy. Prepare uma chave OmniaKey API e um ID de modelo exato antes de abrir WorkBuddy.

O formulário, os detalhes do modelo salvo e o seletor de modelo foram verificados no aplicativo macOS executando WorkBuddy v5.3.14. As instruções oficiais da Tencent Cloud exigem pelo menos v4.22.15 para este recurso.

Antes de começar, prepare dois itens

Uma chave OmniaKey API

Faça login em OmniaKey e abra a página Chaves API:

1. Selecione Criar chave.
2. Nomeie-o como WorkBuddy e defina um limite e uma expiração adequados.
3. Crie-o e copie imediatamente a nova chave.

Mantenha a caixa de diálogo chave aberta até colar a credencial em WorkBuddy. Não coloque a chave em capturas de tela, mensagens de bate-papo ou arquivos públicos.

A conta também precisa de saldo disponível ou crédito de teste. Criar uma chave cria apenas uma credencial; isso não garante que a conta possa financiar uma solicitação.

Um ID exato do modelo

Abra o catálogo de modelos OmniaKey, escolha um modelo atualmente disponível e copie o ID do modelo mostrado na página. Para um primeiro teste, use:

deepseek-v4-flash

O ID deve corresponder exatamente. Não insira o nome de exibição DeepSeek V4 Flash, remova hífens ou invente um alias mais curto.

Etapa 1: Abra Adicionar modelo

Inicie WorkBuddy e abra:

System Settings → Models → + Add model

Na página Modelos, selecione + Adicionar modelo no canto superior direito.

Você também pode entrar na parte inferior de uma nova tarefa:

Model picker → + Configure custom model

Se nenhuma entrada estiver disponível, atualize WorkBuddy para a versão v4.22.15 ou posterior. As instruções atuais da Tencent Cloud exigem pelo menos esta versão para a interface.

Etapa 2: Escolha Personalizado e preencha quatro campos

Preencha o formulário de cima para baixo.

1. Escolha o provedor personalizado

Abra o menu Provedor e selecione:

Custom

Em v5.3.14, ele aparece no grupo Outro. Não escolha o OpenAI integrado, o Tencent Cloud Token Plan ou outro provedor porque esses perfis não usam o endereço de interface OmniaKey.

2. Insira o endereço através de /v1

Em Endereço de interface ou Base URL, insira exatamente:

https://api.omniakey.com/v1

3. Cole a chave API

Cole a chave que você copiou de OmniaKey em API Key. Não adicione aspas, espaços em branco ou a palavra Bearer; insira apenas o valor da chave.

4. Insira o nome do modelo

Em Nome do modelo ou Model ID, insira o ID exato do catálogo:

deepseek-v4-flash

O formulário principal agora deve ser:

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

Para o primeiro teste de conexão, deixe os campos restantes com seus padrões e certifique-se de que Protocolo personalizado esteja desativado. Em v5.3.14, um novo formulário começa com Tool calling ativado, entrada de imagem desativada, modo de raciocínio desativado, protocolo personalizado desativado e limites de entrada e saída padrão do provedor. Uma predefinição deepseek-v4-flash verificada aparece abaixo.

Etapa 3: Salve, selecione o modelo e teste-o

Selecione Salvar e retorne para uma nova tarefa. Abra o seletor de modelo na parte inferior, encontre a seção de modelo personalizado e escolha deepseek-v4-flash.

Envie uma breve mensagem de teste:

Reply with exactly: Connection successful

Uma resposta normal confirma quatro partes da configuração de uma só vez:

1. WorkBuddy salvou o provedor customizado.
2. O Base URL está correto.
3. A chave API é aceita e possui crédito utilizável.
4. A chave pode acessar o ID do modelo selecionado.

Por fim, abra OmniaKey Usage e confirme se a chamada aparece com o modelo esperado. Isso fecha o ciclo de verificação de WorkBuddy para OmniaKey.

Se o modelo salvo não aparecer imediatamente, feche e reabra o seletor. Saia totalmente e reinicie WorkBuddy se ainda não aparecer.

Configurações avançadas recomendadas para o primeiro teste

Não altere vários controles de capacidade antes que o chat básico funcione. Um novo modelo personalizado em WorkBuddy v5.3.14 começa com:

Use esses padrões para verificar primeiro o URL, a chave e o nome do modelo. Em seguida, ajuste os recursos do modelo.

Predefinição deepseek-v4-flash verificada

O modelo salvo e as respostas locais bem-sucedidas usaram esta configuração:

WorkBuddy revela apenas o raciocínio, permite desabilitar o raciocínio e controles de esforço após o modo de raciocínio ser ativado. Deixe o esforço em Auto para o primeiro teste.

Quando ativar a chamada de ferramenta

Ative Tool calling quando WorkBuddy precisar ler arquivos, usar conectores ou executar tarefas de agente. O modelo também deve suportar chamadas de ferramentas estruturadas. deepseek-v4-flash atualmente tem suporte a ferramentas no catálogo OmniaKey, portanto, habilite-o após o bate-papo básico funcionar e comece com uma tarefa somente leitura. Ele pode permanecer desativado para um teste de bate-papo somente com conexão.

Quando ativar a entrada de imagem

Habilite-o apenas para um modelo explicitamente marcado como aceitando imagens. Um switch cliente não pode adicionar capacidade de visão a um modelo somente texto.

Quando ativar o modo de raciocínio

Ative-o quando a documentação do catálogo ou do modelo listar explicitamente o raciocínio, o pensamento ou um modo semelhante. Manter o esforço automático e Permitir desabilitar o raciocínio. Não adicione valores de esforço não suportados e não torne o modo somente raciocínio o padrão para tarefas comuns.

Adicionando outro modelo

Não substitua uma entrada de modelo funcional. Abra Adicionar modelo novamente, mantenha o mesmo URL OmniaKey e chave API, substitua apenas o ID exato do modelo e salve-o como outro modelo personalizado.

Verifique um modelo antes de adicionar o próximo. Quando surge um problema, fica claro qual entrada salva o introduziu.

Solução de problemas por sintoma

A configuração do modelo personalizado está ausente

Verifique primeiro a versão do WorkBuddy. Atualize para v4.22.15 ou posterior e procure no seletor de modelo de nova tarefa ou em Configurações do sistema → Modelos.

HTTP 401, Chave API não autorizada ou inválida

Copie a chave OmniaKey novamente. Verifique se há espaços em branco e certifique-se de não colar Bearer neles. Confirme se a chave está ativada e não expirada e se o saldo da conta e o limite da chave podem ser usados.

Alterar o ID do modelo não corrige 401; a autenticação falhou antes que a seleção do modelo fosse importante.

HTTP 404 ou endpoint não encontrado

O endereço deve ser exatamente:

https://api.omniakey.com/v1

Não use o domínio simples, duplique /v1 ou anexe /chat/completions. Certifique-se também de que Protocolo personalizado esteja desativado.

Modelo não encontrado ou UNKNOWN_MODEL

Copie novamente o ID do catálogo de modelos ativos. Um nome de exibição, um alias adivinhado ou um ID retirado não é um ID de modelo atual válido.

O bate-papo funciona, mas as ferramentas falham

A conexão do modelo básico já está funcionando. Verifique a chave Tool calling do WorkBuddy e a capacidade da ferramenta do modelo. Inserir novamente a chave ou URL API não adicionará suporte à ferramenta.

Falha na entrada de imagem

Ambas as condições devem ser verdadeiras: o modelo suporta imagens e o controle de entrada de imagem do WorkBuddy está habilitado.

O modelo está faltando após salvar

Confirme que você selecionou Salvar e reabra o seletor de modelo. Reinicie WorkBuddy se necessário. Se a entrada de configuração não estiver disponível, verifique novamente a versão do cliente.

Perguntas frequentes

Qual URL OmniaKey WorkBuddy deve usar?

Use apenas https://api.omniakey.com/v1. É um Base URL; WorkBuddy anexa o caminho da operação.

Preciso de um arquivo models.json?

Não. Este guia segue a interface atual Configurar modelo personalizado. As instruções mais antigas do arquivo de configuração local descrevem um caminho de configuração diferente.

Posso configurar GPT, Claude, Gemini ou outro modelo?

Sim, quando o modelo estiver atualmente listado em OmniaKey e suportar a rota compatível com OpenAI. Mantenha o mesmo URL e use o ID exato do modelo de catálogo.

O MCP está configurado neste formulário?

Não. Este formulário configura o modelo API. MCP e conectores são configurações WorkBuddy separadas. Estabeleça uma resposta básica do modelo antes de adicionar essas ferramentas.

Referências verificadas

• Tencent Cloud: configurar e usar WorkBuddy
• Referência OmniaKey OpenAI compatível com API
• Catálogo de modelos vivos OmniaKey