DeepSeek Harness es un marco de Agentes de IA de código abierto desarrollado por DeepSeek, que admite tanto modos de Web UI como de CLI. Conéctelo a Alibaba Cloud Model Studio utilizando Pago por uso, Plan de Codificación, Edición Personal del Plan de Tokens o Edición para Equipos del Plan de Tokens.
Instalar DeepSeek Harness
- Instale Node.js (v22.19.0 o v24.0.0 o posterior).
- Ejecute el siguiente comando para iniciar la Web UI de DeepSeek Harness:
npx @deepseek-ai/dsh web
Después de la ejecución, la Web UI se ejecuta en http://127.0.0.1:3080 de forma predeterminada.
Configurar credenciales
Edite el archivo de configuración ~/.dsh/settings.yaml para agregar un proveedor de Model Studio y un modelo predeterminado. Alternativamente, inicie la Web UI y configure a través de Configuración → Modelos → Agregar un proveedor personalizado.
Token Plan Personal Edition
Reemplace YOUR_API_KEY con la API Key de la Edición Personal del Plan de Tokens. Para consultar los modelos disponibles, véase modelos admitidos de la Edición Personal del Plan de Tokens.
ID de proveedor |
|
URL base |
|
Protocolo de API |
|
Clave API | Clave de API de la Edición Personal del Plan de Tokens |
Modelo | Ingrese un ID de modelo, p. ej., |
También puede editar directamente ~/.dsh/settings.yaml:
agent-default-model:
provider: bailian-tpp
model: auto
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: auto
- id: qwen3.8-max
- id: qwen3.8-flash
- id: qwen3.7-max
- id: qwen3.7-plus
- id: qwen3.6-flash
Establezca la variable de entorno BAILIAN_API_KEY con su API Key de la Edición Personal del Plan de Tokens:
export BAILIAN_API_KEY="YOUR_API_KEY"
Alternativamente, ingrese la API Key directamente en la Web UI bajo Settings → Modelos.
Token Plan Team Edition
Reemplace YOUR_API_KEY con la API Key de la Edición para Equipos del Plan de Tokens. Para consultar los modelos disponibles, véase modelos admitidos de la Edición para Equipos del Plan de Tokens.
ID de proveedor |
|
URL base |
|
Protocolo de API |
|
Clave API | Clave de API de la Edición para Equipos del Plan de Tokens |
Modelo | Ingrese un ID de modelo, p. ej., |
Configuración correspondiente de ~/.dsh/settings.yaml:
agent-default-model:
provider: bailian-tp
model: auto
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: auto
- id: qwen3.8-max
- id: qwen3.8-flash
- id: qwen3.7-max
- id: qwen3.7-plus
- id: qwen3.6-flash
Plan de codificación
Reemplace YOUR_API_KEY con la API Key del Plan de Codificación. Para consultar los modelos disponibles, véase modelos admitidos del Plan de Codificación.
ID de proveedor |
|
URL base | |
Protocolo de API |
|
Clave API | Clave de API del Plan de Codificación |
Modelo | Ingrese un ID de modelo, p. ej., |
Configuración correspondiente de ~/.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
Pago por uso
Reemplace YOUR_API_KEY con su Clave de API de Model Studio. Para consultar los modelos disponibles, véase Compatible con OpenAI - modelos admitidos.
Configure la Base URL según la región. Reemplace {WorkspaceId} en la URL con su ID de espacio de trabajo real:
- Singapur:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - EE. UU. (Virginia):
https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
ID de proveedor |
|
URL base | Consulte la lista de regiones anterior |
Protocolo de API |
|
Clave API | Clave de API de Model Studio (comienza con |
Modelo | Ingrese un ID de modelo, p. ej., |
Configuración correspondiente de ~/.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
Verificación de la configuración
Después de guardar la configuración, seleccione su modelo configurado en el selector de modelos de la Web UI y envíe un mensaje. Si el modelo responde normalmente, la configuración se habrá realizado correctamente.
FAQ
Códigos de error
Si encuentra errores durante la configuración, consulte las preguntas frecuentes del plan de facturación correspondiente:
- Pago por uso: Códigos de error
- Coding Plan: Preguntas frecuentes sobre Coding Plan
- Token Plan Personal Edition: Preguntas frecuentes sobre Token Plan
- Token Plan Team Edition: Preguntas frecuentes sobre Token Plan Team Edition
La obtención de modelos disponibles devuelve 401
El endpoint compatible con OpenAI de Model Studio no proporciona una API GET /models. Al hacer clic en Fetch available models se devuelve 401 o 404. Puede ignorar este botón e ingresar manualmente el ID del modelo en el Catálogo de modelos.
Error MISSING_CREDENTIAL
Vuelva a ingresar la API Key en la Web UI bajo Settings → Modelos y guarde; o confirme que la variable de entorno BAILIAN_API_KEY esté configurada y reinicie DeepSeek Harness.