Tutorial de conexão do DeepSeek Harness (dsh)

O DeepSeek Harness é o framework de execução de agentes open source da DeepSeek (comando dsh), cuja ideia central é "tudo é plugin": modelo, ferramentas, sessão e outras capacidades são todas fornecidas por plugins. Ele permite conectar qualquer gateway por meio da "API de modelo personalizada" — a descrição do grupo GPT-Azure do NextHub já lista o DSH entre as ferramentas de terceiros compatíveis.

Etapas para conectar

1. Instalar e iniciar

Você precisa ter o Node.js instalado (a versão LTS oficial atual é recomendada). Inicie a Web UI diretamente com npx, ou instale globalmente e depois inicie:

npx @deepseek-ai/dsh web

npm install -g @deepseek-ai/dsh
dsh web

Depois de iniciar, o navegador abre automaticamente a interface de gerenciamento local.

2. Adicionar provedor personalizado (canal Claude)

Entre em Configurações → Modelo, clique em Adicionar provedor, troque o cartão para API de modelo personalizada (Custom model API) e preencha conforme a tabela:

Campo	Conteúdo	Observação
Provider ID	nexthub	em minúsculas; não pode ser renomeado depois de criado
URL base	https://api.nexthub.cc	o protocolo Anthropic usa o domínio puro, sem /v1
Protocolo de API	Anthropic Messages	corresponde ao endpoint do protocolo Anthropic Messages
Credencial (API Key)	sua ApiKey do NextHub	grupo da família Claude
Modelo	claude-opus-5-5 etc.	pelo menos um; você pode clicar em "Buscar modelos disponíveis" para obtê-los automaticamente

Depois de salvar, basta selecionar o modelo recém-adicionado na lista de modelos da caixa de diálogo para usá-lo.

3. Conectar o canal GPT (opcional)

Um provedor fala apenas um protocolo; se precisar de GPT, crie outro: em Provider ID coloque nexthub-gpt, em Protocolo de API escolha OpenAI Chat Completions (ou OpenAI Responses), em URL base coloque https://api.nexthub.cc/v1 (com /v1), use como API Key a chave do grupo GPT-Azure / GPT-Pro e preencha os modelos gpt-5.6, gpt-6-astra etc.

4. Verificar

Selecione um modelo do NextHub na caixa de diálogo, envie uma mensagem e, se receber uma resposta normal, a conexão foi feita com sucesso.

Modo arquivo de configuração (opcional)

A configuração acima acaba sendo gravada em $DSH_HOME/profiles/web/cordis.patch.yml (o DSH_HOME padrão é ~/.dsh), e você também pode editar esse arquivo diretamente:

- id: llm-pi-ai
  config:
    providers:
      nexthub:
        apiKeyEnv: NEXTHUB_API_KEY
        api: anthropic-messages
        baseURL: https://api.nexthub.cc
        models:
          - id: claude-opus-5-5
          - id: claude-fable-5

Em apiKeyEnv vai o nome da variável de ambiente (a chave em si é lida dessa variável); a chave salva pela interface fica guardada em $DSH_HOME/.credentials.yaml. Depois de alterar, não é preciso reiniciar: a próxima requisição já usa o novo valor.

Modelo de visão precisa declarar os tipos de entrada

Por padrão, um modelo cadastrado manualmente é tratado como texto puro. Para enviar imagens ao modelo, marque Image em Input types nas Model options do modelo (o que corresponde à configuração input: [text, image]); caso contrário, o envio de imagens é recusado antes do disparo.