Guía de agentes de Flaq AI

Guía práctica para usar DeepSeek Harness con la API compatible con OpenAI de Flaq AI

Ejecuta la interfaz web de código abierto de DeepSeek Harness con el endpoint compatible con OpenAI de Flaq AI y conecta un modelo DeepSeek v4 compatible para analizar repositorios y realizar flujos de trabajo de programación. DeepSeek Harness sigue una arquitectura en la que «todo es un plugin»: los adaptadores de modelos, las herramientas, el bucle del agente, el almacenamiento de sesiones, los permisos, el aislamiento, la telemetría y la interfaz web se pueden combinar o sustituir mediante plugins y configuración.

Guías de agentes

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Instalar

Ejecutar DeepSeek Harness

DeepSeek Harness requiere Node.js 22.19+ o una versión 24+. Inícialo desde el directorio del proyecto que quieras usar como ubicación predeterminada del sistema de archivos; el comando npm oficial abre la interfaz web en http://127.0.0.1:3080 de forma predeterminada.

1

Ejecutar la interfaz web de DeepSeek Harness

Usa el paquete npm oficial para iniciar la interfaz web. Mantén esta terminal en ejecución mientras usas DeepSeek Harness.

La primera ejecución descarga el paquete @deepseek-ai/dsh actual e inicializa el perfil de la interfaz web.

Comando npm oficial

npx @deepseek-ai/dsh web

Repositorio: Consulta las instrucciones de instalación, versiones, notas de compatibilidad y código fuente más recientes en el repositorio oficial de DeepSeek Harness en GitHub.

Configurar

Conectar DeepSeek Harness con Flaq AI

Abre Settings → Models en DeepSeek Harness, añade Flaq AI como proveedor personalizado e introduce tu clave de API de Flaq. El Provider ID es permanente después de guardarlo, así que usa flaq salvo que necesites deliberadamente un nombre de ruta diferente. Después de guardar el proveedor, elige un espacio de trabajo antes de iniciar una sesión.

Modelo DeepSeek v4 Pro recomendado para analizar repositorios, realizar tareas de programación y ejecutar flujos de trabajo que se benefician de un razonamiento más avanzado.

En Settings → Models, selecciona Add provider → Add a custom provider. Introduce los valores indicados a continuación y añade manualmente el ID del modelo seleccionado en lugar de usar Fetch available models. Guarda el proveedor y selecciona ese modelo para una nueva sesión. DeepSeek Harness trata los modelos introducidos manualmente como modelos de solo texto, a menos que se declaren modalidades adicionales.

  • Usa exactamente la URL base de Flaq y el protocolo openai-completions.
  • Sustituye el marcador de posición por tu clave de API de Flaq y conserva el ID del modelo exactamente como se muestra.

Proveedor personalizado de Flaq AI

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

Verificar

Verificar Flaq en DeepSeek Harness

Abre la interfaz web, elige el directorio del proyecto en el que iniciaste DeepSeek Harness, selecciona el modelo Flaq configurado y crea una nueva sesión. El editor permanece deshabilitado hasta que se selecciona un espacio de trabajo.

  • DeepSeek Harness muestra la URL activa en la terminal.
  • A continuación se indica la dirección local predeterminada.

Abrir la interfaz web

http://127.0.0.1:3080
  • Envía primero una tarea de solo lectura.
  • Una respuesta normal que refleje el espacio de trabajo seleccionado confirma que DeepSeek Harness puede acceder al endpoint de Flaq y usar el modelo configurado.

Probar el acceso al repositorio

Summarize this repository and identify its main packages. Do not modify any files.

Ejemplo de plugin

Instalar un plugin de DeepSeek Harness

Usa DSH OpenPencil como ejemplo concreto de la arquitectura de DeepSeek Harness en la que «todo es un plugin». Completa la configuración y verificación del proveedor Flaq descritas anteriormente, detén la interfaz web en ejecución, añade el plugin al perfil web y reinicia la misma versión de DeepSeek Harness. DSH OpenPencil incorpora herramientas para crear, previsualizar, inspeccionar y editar documentos de diseño .op dentro de una conversación.

1

Instalar DSH OpenPencil

Añade el paquete público de OpenPencil al perfil web con la versión de DeepSeek Harness que el plugin tiene probada actualmente. Ejecuta este comando desde el mismo directorio del proyecto que usas para DeepSeek Harness.

Instalar DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

Repositorio: Consulta el código fuente, los requisitos de configuración, las versiones y las notas de compatibilidad en el repositorio de DSH OpenPencil en GitHub.

2

Reiniciar la interfaz web

Inicia de nuevo la versión probada de DeepSeek Harness para que el perfil web cargue DSH OpenPencil. Mantén esta terminal en ejecución mientras vuelves a abrir la interfaz web.

Reiniciar la interfaz web

npx --yes -p @deepseek-ai/[email protected] dsh web
3

Probar DSH OpenPencil con Flaq AI

Selecciona el modelo Flaq configurado y el espacio de trabajo, inicia una nueva sesión y envía la solicitud que aparece a continuación. Cuando el binario de OpenPencil esté disponible, el plugin debería crear un documento .op y mostrar una vista previa editable en la conversación.

Probar DSH OpenPencil con Flaq AI

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

Código abierto

Explorar el repositorio oficial de DeepSeek Harness

DeepSeek Harness es una estructura de agentes de código abierto desarrollada por DeepSeek AI. Visita el repositorio oficial para consultar el código fuente, seguir las versiones y los cambios de compatibilidad, leer la documentación más reciente e informar de problemas durante la vista previa para desarrolladores.

DeepSeek Harness en GitHub

Abre el repositorio oficial de DeepSeek Harness para consultar el código fuente, la documentación de configuración, las notas de desarrollo, las conversaciones y las novedades del proyecto.

Guía de código abierto

Explorar la guía de código abierto de Flaq AI sobre DeepSeek Harness

Ve más allá de la configuración inicial con la guía independiente de DeepSeek Harness mantenida por la comunidad de Flaq AI. Descubre cómo su árbol de plugins, perfiles, paquetes, capas de parches, bucle de agente sustituible, adaptadores de modelos, herramientas, servicios de sesión, políticas de permisos, entornos aislados y extensiones de la interfaz web permiten crear flujos de trabajo de agentes personalizados.

Guía de DeepSeek Harness en GitHub

Explora notas prácticas sobre la arquitectura, un manual de uso, recetas de desarrollo de plugins, documentación multilingüe y skills de agentes reutilizables para comprender, ampliar y desarrollar soluciones basadas en DeepSeek Harness.

Solución de problemas

Preguntas frecuentes sobre DeepSeek Harness

Usar esta configuración de la guía puede aumentar significativamente el uso de tokens.

Conversaciones sobre DeepSeek Harness en X (Twitter)

Explora conversaciones de desarrolladores y primeros participantes sobre DeepSeek Harness (DSH), una estructura de agentes de código abierto, que abarcan su arquitectura en la que «todo es un plugin», el entorno de ejecución componible, el ecosistema de plugins y experiencias prácticas.