English Arabic Français Deutsch 日本語 한국어 Português Русский Español

DeepSeek Harness con Novita AI: Guía de configuración, clave API y elección de modelo

Por / / AI Agents, LLM / 15 minutos de lectura
DeepSeek Harness con Novita AI: Guía de configuración, clave API y elección de modelo
Tabla de contenido
  1. Qué es DeepSeek Harness
  2. Qué necesitas antes de la configuración
  3. Cómo conectar modelos de Novita AI
  4. Qué puedes ejecutar después de la configuración
  5. Cómo elegir un modelo para el trabajo
  6. Solución de problemas comunes de configuración
  7. Preguntas frecuentes
  8. Artículos recomendados
  9. Fuentes

DeepSeek Harness funciona con Novita AI lanzando la interfaz web de Harness localmente y añadiendo Novita AI como un proveedor de modelos personalizado compatible con OpenAI. Instala Node.js, ejecuta npx @deepseek-ai/dsh web, abre http://127.0.0.1:3080, luego usa https://api.novita.ai/openai como URL base del proveedor, una clave API de Novita AI como credencial, y un ID de modelo de tu biblioteca de modelos de Novita AI. La configuración toma unos minutos; el verdadero trabajo es elegir el modelo adecuado para programación, análisis de repositorios, investigación o tareas de alto volumen.

Qué es DeepSeek Harness

DeepSeek Harness es un harness de agentes de código abierto de DeepSeek AI construido en torno a una arquitectura de “todo es un plugin”. La documentación oficial describe el proyecto como en vista previa para desarrolladores y advierte que es probable que haya cambios que rompan la compatibilidad, por lo que la mejor postura de producción es fijar una versión funcional, revisar los cambios antes de actualizar y validar la integración después de cada actualización.

La distinción entre el modelo y el harness es más fácil de ver una vez que los ejecutas. Un LLM lee el prompt y decide qué hacer a continuación. Un harness le da a esa decisión una ruta de ejecución: un espacio de trabajo, herramientas, un shell, un navegador, sesiones, almacenamiento y una forma de observar lo que sucedió antes de elegir la siguiente acción. DeepSeek Harness empaqueta ese bucle en una interfaz web que ejecutas en tu propia máquina, mientras que el modelo de razonamiento puede seguir siendo un servicio API.

Ese diseño se adapta a varios tipos de trabajo:

  • Cambios en el código base. Deja que el agente inspeccione archivos, proponga un parche, ejecute pruebas y revise después de los fallos.
  • Triaje de repositorios. Explora una dependencia desconocida, mapea rutas de llamadas, resume áreas de riesgo y escribe tickets de seguimiento.
  • Investigación e informes. Combina navegación, salida de archivos y resúmenes estructurados cuando la respuesta está repartida en muchas páginas.
  • Experimentos de operaciones. Redacta scripts, ejecútalos localmente con aprobación y registra lo que cambió antes de escalar el flujo de trabajo.

Es menos adecuado cuando necesitas una llamada API pequeña y auditable sin acceso a archivos ni ejecución local. Un harness de agentes es un entorno de desarrollo, no solo un endpoint de inferencia. Si solo necesitas completaciones de chat, la API LLM de Novita AI directa es más sencilla.

Qué necesitas antes de la configuración

Necesitas cuatro cosas:

  1. Una máquina con Node.js instalado.
  2. Una cuenta de Novita AI.
  3. Una clave API de Novita AI.
  4. Un directorio de trabajo que el agente pueda leer y, cuando corresponda, editar.

Para confirmar que Node.js está instalado, ejecuta:

node --version

El repositorio oficial de DeepSeek Harness actualmente declara soporte para Node.js ^22.19.0 || >=24.0.0. Si el comando muestra una versión anterior o falla, instala Node.js desde nodejs.org, luego vuelve a ejecutar la comprobación. Evita ejecutar comandos como administrador del sistema si puedes; si npx falla porque no puede escribir en una caché global, corrige tus permisos de Node.js/npm en lugar de abrir un shell como root.

Antes de terminar la configuración, crea una carpeta de proyecto dedicada y ponla bajo control de versiones si el contenido importa. Un harness con acceso a herramientas puede ser enormemente útil, pero “mira este código” es un nivel de riesgo diferente a “publica en producción”. Revisa las acciones propuestas por el agente y evita conectarlo a credenciales que no necesita.

Cómo conectar modelos de Novita AI

Paso 1: Obtén tu clave API de Novita AI

Inicia sesión en Novita AI, abre Key Management, crea una nueva clave y cópiala inmediatamente. Si la consola muestra la clave solo una vez, guárdala en un gestor de contraseñas o en el almacén de secretos local que tu equipo ya use. No la pegues en documentación, una captura de pantalla, un repositorio de código fuente o un chat compartido.

Para esta guía, expórtala en el shell que lanzará Harness:

export NOVITA_API_KEY="your-key"

La variable solo facilita la configuración; la configuración del proveedor en la interfaz de la siguiente sección es lo que Harness usa para hacer llamadas al modelo.

Paso 2: Ejecuta la interfaz web de DeepSeek Harness

El README oficial proporciona esta ruta de lanzamiento con npm:

npx @deepseek-ai/dsh web

La primera ejecución descarga el paquete y sus dependencias, por lo que puede tardar más que las siguientes. DeepSeek Harness luego abre la interfaz web en http://127.0.0.1:3080 por defecto y la lanza en tu navegador predeterminado. Si trabajas por SSH o no quieres que se abra el navegador, el README oficial documenta la flag --no-open:

npx @deepseek-ai/dsh web --no-open

DeepSeek Harness también se puede ejecutar desde el código fuente con pnpm install, pnpm run build y pnpm dsh web, pero la ruta npm es la forma más rápida de obtener una interfaz funcional y es la que usa esta guía.

Paso 3: Añade Novita AI como proveedor personalizado

Las etiquetas exactas pueden cambiar a medida que DeepSeek Harness itera, pero el objetivo es el mismo en la interfaz web actual: abre la configuración de modelo/proveedor y añade un proveedor personalizado compatible con OpenAI.

Campo Valor a usar
Nombre para mostrar Novita AI
ID del proveedor novita u otro identificador local estable
URL base https://api.novita.ai/openai
Clave API Tu clave API de Novita AI
Catálogo de modelos Actualiza o añade los IDs de modelo específicos de Novita AI que desees

Usa https://api.novita.ai/openai, no una ruta a un modelo específico. Mantén estable el ID del proveedor; si lo cambias de nombre más tarde, la configuración de sesiones existentes puede apuntar a un proveedor que ya no existe. Después de guardar el proveedor, actualiza el catálogo de modelos y haz que el modelo sea visible en el selector de sesión.

El protocolo de API a elegir es openai-completions. DeepSeek Harness documenta este protocolo para OpenAI Chat Completions y ofrece openai-responses y anthropic-messages para puertas de enlace que usan esas formas de solicitud en su lugar.

Paso 4: Selecciona el modelo y el espacio de trabajo

Abre un espacio de trabajo en la interfaz de DeepSeek Harness y elige uno de los modelos de Novita AI que acabas de añadir. Si la interfaz tiene una acción “get models”, úsala en lugar de escribir un ID de modelo de memoria. Los IDs de modelo son el contrato de integración: un ID incorrecto puede parecer un problema de red, un problema de permisos o un catálogo vacío.

Luego ejecuta una tarea pequeña antes de usar un código base importante:

List the files in this workspace, identify the main entry point, and propose one low-risk documentation improvement.

Confirma que el agente puede leer el espacio de trabajo, llamar al modelo y detenerse antes de una acción que no aprobaste. Una vez que ese bucle funcione, pasa a una tarea real.

Si el descubrimiento de modelos no completa la lista, añade el ID del modelo manualmente. DeepSeek Harness documenta el descubrimiento como una conveniencia porque no todas las puertas de enlace devuelven el mismo formato de listado.

Qué puedes ejecutar después de la configuración

DeepSeek Harness te da un lugar para definir y operar sesiones de agentes, no solo hacer preguntas de seguimiento. Algunos puntos de partida prácticos:

Explica y refactoriza una ruta de código existente

Apunta el espacio de trabajo a un servicio o paquete y pide al agente que rastree una característica de principio a fin. La salida útil no es solo prosa; puede incluir un plan de cambios, los archivos que tocaría, las pruebas que añadiría y las señales que probarían que la refactorización funcionó.

Trace how an incoming request reaches the database layer. Produce a numbered flow, list likely failure points, and propose tests for the two highest-risk paths.

Revisa el plan antes de permitir ediciones. Un modelo puede elegir una ruta de aspecto coherente a través de un código base que depende de un inicializador implícito, una ruta de configuración obsoleta o una API antigua que todavía tiene llamadas en producción.

Prepara una migración o limpieza

Harness es útil para tareas de “preparar el trabajo”. Pide un inventario de dependencias, una lista de uso de API, una lista de verificación de compatibilidad o un plan de migración por etapas. Esos artefactos son más fáciles de revisar que un parche grande de una sola vez, y preservan el juicio que necesitas si la migración afecta a otros equipos.

Ejecuta un flujo de trabajo de investigación a archivo

Para escaneos de mercado o comparaciones técnicas, pide al agente que recopile fuentes, concilie fechas, anote desacuerdos y escriba un informe preliminar en un archivo local. Mantén el entregable acotado: “produce una tabla de candidatos con URLs y fechas” es más fácil de verificar que “dime qué está pasando en este mercado”.

Construye un flujo de trabajo local repetible

Una vez que un prompt funciona, guárdalo como un prompt de proyecto o plugin si tu versión de Harness lo admite. Un prompt reutilizable debe indicar el espacio de trabajo, las entradas requeridas, el formato de salida y los límites de seguridad. Esa última parte importa cuando el flujo de trabajo ejecuta comandos o edita archivos.

Cómo elegir un modelo para el trabajo

Novita AI admite DeepSeek y otras familias de modelos, por lo que la pregunta no es “¿qué proveedor tiene un modelo?” sino “¿qué modelo debería usar esta etapa del flujo de trabajo?” Comienza con los listados actuales en la biblioteca de modelos de Novita AI y confirma el ID exacto del modelo en la página del modelo antes de guardarlo en Harness. Los IDs de modelo y los límites cambian a medida que se actualizan los catálogos.

Usa estos patrones de enrutamiento como punto de partida:

  • DeepSeek V4.1 Flash es útil cuando quieres un razonamiento general sólido para análisis de código, tareas con muchas matemáticas o explicaciones de varios pasos sin el perfil de coste de un modelo insignia.
  • GLM 5.3 es el listado insignia de GLM en el momento de escribir esto, mientras que GLM 5.3 Flash es la opción multimodal nativa orientada a la eficiencia. Verifica la ventana de contexto y los límites de salida antes de meter un repositorio completo en una sola solicitud.
  • Qwen3.8 Flash y Qwen3.8 Max cubren los extremos de eficiencia e insignia de la actual línea Qwen3.8. Ejecuta la misma tarea de parche contra tu predeterminado para ver si la salida es más fácil de revisar.
  • Kimi K3 es el actual insignia de Moonshot en el catálogo de Novita y puede encajar en flujos de trabajo de contexto largo, investigación y uso intensivo de herramientas. Confirma el comportamiento exacto de la API para llamadas a herramientas antes de confiar en él en producción.
  • MiniMax M3 es el listado más reciente de MiniMax y es un candidato para trabajo interactivo eficiente y de entrada multimodal. Mide la latencia y la calidad de revisión en tus propios prompts en lugar de asumir que un resultado de benchmark se transferirá.

Para el trabajo de agentes en producción, tres mediciones importan más que una tabla de clasificación:

  1. Éxito de la tarea. ¿El parche pasa las pruebas? ¿El informe contiene las secciones solicitadas? ¿La llamada a la herramienta hace la acción prevista?
  2. Coste por resultado aceptado. Cuenta los reintentos, la salida desperdiciada y el tiempo humano dedicado a revisar planes malos.
  3. Modo de fallo. ¿El modelo se niega educadamente, alucina una llamada a herramienta o realiza con confianza una acción incorrecta? El último necesita ajustes de aprobación más estrictos.

Si quieres comparar dos modelos sin editar el proveedor cada vez, añade ambos al mismo proveedor de Novita AI, guarda sus IDs de modelo exactos y ejecuta el mismo conjunto de prompts representativos. Luego inspecciona los artefactos finales, no solo la salida del chat.

Solución de problemas comunes de configuración

La lista de modelos está vacía

Comprueba que la URL base sea exactamente https://api.novita.ai/openai, que la clave API esté vigente y que tu cuenta tenga acceso al modelo. Si la interfaz tiene una acción de actualización, actualiza el catálogo después de guardar el proveedor. Luego prueba la clave fuera de Harness con una llamada API directa.

Si la obtención de modelos devuelve un error de autenticación, revisa primero la clave. El descubrimiento de Harness llama al endpoint de lista de modelos compatible con OpenAI y puede fallar allí, mientras que las llamadas de completado normales fallan por una razón diferente.

El proveedor se guarda, pero las solicitudes fallan

Confirma que el ID del modelo coincida con la página del modelo de Novita AI. También comprueba si el modelo seleccionado admite el tipo de solicitud que está haciendo el harness; un modelo solo de texto puede no admitir una solicitud de imagen, y un modelo sin soporte de herramientas puede fallar en un paso de agente que espera llamadas a herramientas.

npx se cuelga o falla en el primer lanzamiento

El primer lanzamiento descarga dependencias y puede tardar un rato. Si falla, revisa tu red, la caché de npm y la versión de Node.js. Un reintento limpio es razonable; si el error menciona permisos, prefiere una instalación de Node.js a nivel de usuario o la caché del gestor de paquetes en lugar de ejecutar el comando con privilegios elevados.

El navegador no se abre

Es posible que el servidor siga en ejecución. Abre http://127.0.0.1:3080 manualmente, o reinicia con npx @deepseek-ai/dsh web --no-open y visita la URL desde un navegador en la misma máquina. Por SSH, el host reenviado puede no ser 127.0.0.1, así que usa la dirección impresa por el comando.

El agente hizo un cambio inesperado

Detén la ejecución, inspecciona el diff de tu control de versiones y revierte lo que no quieras. Luego reduce el alcance de las herramientas o ejecuta la tarea en un espacio de trabajo desechable. Si tu equipo usa ramas protegidas y credenciales de despliegue, manténlas fuera del alcance del agente hasta que confíes en el flujo de trabajo.

Preguntas frecuentes

¿DeepSeek Harness admite modelos de Novita AI?

DeepSeek Harness admite proveedores personalizados compatibles con OpenAI, y Novita AI expone una API compatible con OpenAI. Esta guía usa la ruta de proveedor personalizado: https://api.novita.ai/openai como URL base, una clave API de Novita AI y el ID exacto del modelo de la página del modelo de Novita AI.

¿Necesito desplegar mi propio servidor de modelos?

No. Novita AI aloja la API del modelo; DeepSeek Harness se ejecuta localmente y llama a esa API. No necesitas gestionar GPU para esta configuración. Aún necesitas suficientes recursos locales para el proceso de Node.js y las herramientas que ejecute el agente.

¿DeepSeek Harness está listo para producción?

El repositorio oficial describe DeepSeek Harness como una vista previa para desarrolladores y advierte sobre cambios que rompen la compatibilidad. Puede ser útil hoy, pero fija versiones, revisa las notas de la versión, mantén el trabajo importante bajo control de versiones y prueba las actualizaciones en un espacio de trabajo no crítico antes de cambiar un flujo de trabajo en producción.

¿Puedo usar más de un modelo en el mismo proyecto?

Sí, si la interfaz admite cambiar de modelo en tu sesión. Un patrón útil es un modelo para redactar o código de primera pasada, otro para revisión o análisis más profundo, y un modelo de menor coste para resumen, clasificación o extracción repetida.

¿Dónde debo guardar mi clave API de Novita AI?

Ponla en la configuración del proveedor solo cuando sea necesario; de lo contrario, guárdala en un gestor de secretos local o en un almacén de entorno cifrado. Nunca la confirmes en el repositorio, la compartas en capturas de pantalla ni le otorgues permisos más amplios de los que necesita la tarea.

¿Qué debo hacer antes de conectar un código base real?

Pon el espacio de trabajo bajo control de versiones, confirma la configuración de aprobación del agente y elimina las credenciales que no sean necesarias. Comienza con una tarea de solo lectura o de bajo riesgo, luego amplía el conjunto de herramientas después de entender cómo se comporta el agente con tu proyecto.

Artículos recomendados

Fuentes

Publicaciones relacionadas