DeepSeek Harness
Tools, sessions y adaptadores de modelo en DeepSeek Harness
Entiende cómo estas superficies convierten una respuesta de modelo en una tarea persistente con herramientas.
Qué aprenderás
- Tools combine schemas, scoped registration, and guarded execution.
- The append-only session log is the source of model-visible context.
- LLM adapters expose a provider seam and streaming interception point.
Antes de empezar
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
Conclusiones clave
- Tools combina schemas, scope y ejecución protegida.
- El Session Log es la fuente del contexto del modelo.
- El adaptador LLM es el punto de intercambio del proveedor.
Pipeline de tools
Tools es un registro con scope y una ejecución protegida. El schema entra en el prompt y la llamada pasa por pre-execute, execute y post-execute.
La separación permite rechazar llamadas y medir latencia sin modificar el Agent Loop.
La sesión como fuente
El Session Log guarda hechos visibles para el modelo como eventos append-only; deriveMessages proyecta el historial y los chunks conservan fidelidad de replay.
Todo dato que entra en una petición debe poder reconstruirse desde el log para evitar contexto oculto.
El adaptador LLM
El runtime LLM registra rutas de proveedores, resuelve metadatos y mantiene estable el registro durante la llamada preparada.
`llm/stream` permite retry, replay y routing; los errores de middleware o consumidor siguen propagándose.
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
Localiza registro y ejecución de tools.
- 2
Sigue un hecho hasta el Session Log.
- 3
Encuentra la ruta del adaptador.
- 4
Mide por separado errores de tool y proveedor.
Ejemplo para copiar
ctx.tools -> prompt schema -> tools/pre-execute
-> tools/execute -> tools/post-execute
ctx.llm -> prepareCall -> llm/stream -> provider adapterPreguntas frecuentes
¿Puede una tool saltarse el Session Log?
Los hechos visibles para el modelo deben ser eventos para conservar replay y reconstrucción.
Fuentes
- DeepSeek Harness tools subsystemFuente verificada 2026-08-27
- DeepSeek Harness session subsystemFuente verificada 2026-08-27
- DeepSeek Harness LLM streaming subsystemFuente verificada 2026-08-27