DeepSeek Harness
Agent Loop de DeepSeek Harness: steps, turns y eventos
Sigue una tarea por el loop y elige el evento correcto para extender sesión, agente o capacidades.
Qué aprenderás
- A step is one model request plus tools; a turn can contain multiple steps.
- The session log reconstructs model-visible history.
- Event domains separate durable facts from live interception points.
Antes de empezar
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
Conclusiones clave
- Un step es una petición más herramientas; un turn agrupa steps.
- El registro reconstruye el contexto visible al modelo.
- Los dominios separan hechos duraderos de intercepción en vivo.
Step frente a turn
Un step es una petición de modelo con sus herramientas; un turn puede contener varios steps hasta que no queda trabajo pendiente.
Esta distinción evita contar una llamada de herramienta y la siguiente petición como dos turnos de usuario.
Ruta de ejecución
El turn reclama entrada, ensambla prompts y schemas, deriva historial, transmite la respuesta, ejecuta herramientas, registra resultados y decide si continúa.
Los eventos de sesión son duraderos. agent/request, llm/stream y tools/execute son waterfalls en vivo que deben llamar a next().
Elige el dominio
Usa session/event para hechos reproducibles, agent/* para trabajo en vivo y tools/* o fs/* para políticas y adaptadores.
Antes de añadir comportamiento, decide si debe sobrevivir a reload y qué servicio posee el contrato.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Sigue turn/start hasta turn/end.
- 2
Marca eventos persistidos.
- 3
Localiza waterfalls.
- 4
Elige evento según replay e intercepción.
Ejemplo para copiar
turn/start -> step/start -> agent/request -> llm/stream
-> tools/execute -> tool/result -> step/end -> turn/endPreguntas frecuentes
¿Por qué son duraderos los eventos de sesión?
Se guardan en el log para reconstruir historial, replay, transcripciones y UI.
Fuentes
- DeepSeek Harness architecture turn flowFuente verificada 2026-08-27
- DeepSeek Harness core subsystemFuente verificada 2026-08-27