DeepSeek Harness

Usa esta guía para ejecutar el DeepSeek Harness de código abierto con modelos servidos por Felo API Platform. La ruta recomendada reutiliza el adaptador deepseek-official integrado del harness. También puedes añadir Felo como proveedor personalizado independiente compatible con OpenAI en la interfaz web.

DeepSeek Harness es actualmente una vista previa para desarrolladores y puede introducir cambios que rompan la compatibilidad. Consulta sus notas de versión upstream cuando una opción o una pantalla difieran de esta guía.

Antes de empezar

Necesitas Node.js y una clave de Felo API Platform. Mantén la clave fuera del control de código fuente.

export FELO_API_KEY="YOUR_API_KEY"

Los ejemplos usan deepseek-v4-flash. Consulta Modelos y precios antes de elegir otro ID de modelo.

Configuración recomendada: adaptador DeepSeek integrado

DeepSeek Harness lee la credencial del adaptador integrado de DEEPSEEK_API_KEY y su endpoint de DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

Abre http://127.0.0.1:3080 y después:

1. Añade o selecciona el espacio de trabajo de tu proyecto.
2. Abre Settings → Models.
3. Selecciona el proveedor deepseek-official y el modelo deepseek-v4-flash.
4. Inicia una nueva sesión y envía una tarea pequeña sobre el repositorio.

No añadas /chat/completions a la URL base. El adaptador integrado envía las solicitudes a {DEEPSEEK_BASE_URL}/chat/completions por sí mismo.

Conservar los valores de entorno

DeepSeek Harness puede leer un archivo .env del directorio desde el que lo inicias. Añade los siguientes valores a un archivo .env no rastreado si no quieres exportarlos en cada sesión:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

No confirmes este archivo en el control de versiones. También puedes usar los archivos de credenciales y configuración del harness en $DSH_HOME cuando necesites configuración a nivel de usuario.

Configuración alternativa: proveedor personalizado compatible con OpenAI

Usa esta ruta cuando quieras que Felo aparezca como un proveedor independiente en lugar de sobrescribir la conexión integrada de DeepSeek.

1. Inicia la interfaz web con npx @deepseek-ai/dsh web.
2. Abre Settings → Models.
3. Elige Add custom provider.
4. Introduce los siguientes valores y guarda el proveedor.

Si falla el descubrimiento de modelos, añade el ID de modelo manualmente. La acción Get available models de un proveedor depende de una ruta GET /models compatible con OpenAI y no es necesaria para la configuración manual.

Verificar la configuración

Inicia una sesión nueva y pregunta:

Summarize this repository and identify its main packages.

La configuración está lista cuando la sesión termina con deepseek-v4-flash seleccionado y no aparece ningún error de autenticación ni de modelo desconocido.

Para una prueba rápida no interactiva con el adaptador recomendado, ejecuta desde el espacio de trabajo de destino:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

Nota sobre la búsqueda web

Esta configuración enruta las solicitudes de modelos a través de Felo. El proveedor web_search integrado de DeepSeek Harness tiene requisitos de endpoint distintos, aunque su variable de credencial predeterminada también sea DEEPSEEK_API_KEY. No apuntes DEEPSEEK_SEARCH_BASE_URL a Felo salvo que uses un endpoint de búsqueda explícitamente compatible. Usa la Chat API de Felo u otras Felo Skills por separado cuando tu flujo de trabajo necesite la búsqueda de Felo.

Solución de problemas

Siguientes pasos

• Repositorio de DeepSeek Harness
• Referencia de la LLM API
• Referencia de la Chat API
• Felo Skills para agentes de IA