DeepSeek Harness - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

O DeepSeek Harness é um framework de AI Agent open-source desenvolvido pela DeepSeek, com suporte aos modos Web UI e CLI. Conecte-o ao Alibaba Cloud Model Studio usando as modalidades pagamento conforme o uso, Coding Plan, Token Plan Personal Edition ou Token Plan Team Edition.

Instale o DeepSeek Harness

Instale o Node.js (v18.0 ou superior).
Execute o comando a seguir para iniciar a Web UI do DeepSeek Harness:

npx @deepseek-ai/dsh web

Após a execução, a Web UI estará disponível por padrão em http://127.0.0.1:3080.

Configure credenciais

Edite o arquivo de configuração ~/.dsh/settings.yaml para adicionar um provedor do Model Studio e definir o modelo padrão. Alternativamente, inicie a Web UI e configure por meio de Settings → Models → Add a custom provider.

Token Plan Personal Edition

Substitua YOUR_API_KEY pela API Key do Token Plan Personal Edition. Para consultar os modelos disponíveis, veja Token Plan Personal Edition supported models.

Provider ID	`bailian-tpp`
Base URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API Protocol	`openai-completions`
API Key	API Key do Token Plan Personal Edition
Model	Insira um ID de modelo, por exemplo, `qwen3.8-max`

Você também pode editar diretamente o arquivo ~/.dsh/settings.yaml:

agent-default-model:
  provider: bailian-tpp
  model: qwen3.8-max

llm-pi-ai:
  providers:
    bailian-tpp:
      api: openai-completions
      baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

Defina a variável de ambiente BAILIAN_API_KEY com sua API Key do Token Plan Personal Edition:

export BAILIAN_API_KEY="YOUR_API_KEY"

Como alternativa, insira a API Key diretamente na Web UI, em Settings → Models.

Token Plan Team Edition

Substitua YOUR_API_KEY pela API Key do Token Plan Team Edition. Para consultar os modelos disponíveis, veja Token Plan Team Edition supported models.

Provider ID	`bailian-tp`
Base URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API Protocol	`openai-completions`
API Key	API Key do Token Plan Team Edition
Model	Insira um ID de modelo, por exemplo, `qwen3.8-max`

Configuração correspondente no arquivo ~/.dsh/settings.yaml:

agent-default-model:
  provider: bailian-tp
  model: qwen3.8-max

llm-pi-ai:
  providers:
    bailian-tp:
      api: openai-completions
      baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

Coding Plan

Substitua YOUR_API_KEY pela API Key do Coding Plan. Para consultar os modelos disponíveis, veja Coding Plan supported models.

Provider ID	`bailian-coding`
Base URL	`https://coding-intl.dashscope.aliyuncs.com/v1`
API Protocol	`openai-completions`
API Key	API Key do Coding Plan
Model	Insira um ID de modelo, por exemplo, `qwen3.7-plus`

Configuração correspondente no arquivo ~/.dsh/settings.yaml:

agent-default-model:
  provider: bailian-coding
  model: qwen3.7-plus

llm-pi-ai:
  providers:
    bailian-coding:
      api: openai-completions
      baseURL: https://coding-intl.dashscope.aliyuncs.com/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.7-plus
        - id: qwen3.6-plus

Pagamento conforme o uso

Substitua YOUR_API_KEY pela sua Model Studio API Key. Para consultar os modelos disponíveis, veja OpenAI compatible - supported models.

Defina a Base URL de acordo com a região. Substitua {WorkspaceId} na URL pelo seu Workspace ID real:

Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
US (Virginia): https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1

Provider ID	`bailian`
Base URL	Consulte a lista de regiões acima
API Protocol	`openai-completions`
API Key	API Key do Model Studio (começa com `sk-`)
Model	Insira um ID de modelo, por exemplo, `qwen3.7-max`

Configuração correspondente no arquivo ~/.dsh/settings.yaml:

agent-default-model:
  provider: bailian
  model: qwen3.7-max

llm-pi-ai:
  providers:
    bailian:
      api: openai-completions
      baseURL: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

Verifique a configuração

Após salvar a configuração, selecione o modelo configurado no seletor de modelos da Web UI e envie uma mensagem. Se o modelo responder normalmente, confirme que a configuração foi concluída com sucesso.

Perguntas frequentes

Códigos de erro

Se você encontrar erros durante a configuração, consulte as perguntas frequentes do plano de faturamento correspondente:

Pagamento conforme o uso: Error codes
Coding Plan: Coding Plan FAQ
Token Plan Personal Edition: Token Plan FAQ
Token Plan Team Edition: Token Plan Team Edition FAQ

A busca de modelos disponíveis retorna 401

O endpoint compatível com OpenAI do Model Studio não oferece uma API GET /models. Ao clicar em Fetch available models, o sistema retorna 401 ou 404. Ignore esse botão e insira manualmente o ID do modelo no catálogo de modelos.

Erro MISSING_CREDENTIAL

Insira novamente a API Key na Web UI, em Settings → Models, e salve; ou verifique se a variável de ambiente BAILIAN_API_KEY está definida e reinicie o DeepSeek Harness.