Cómo utilizar esta referencia
- Utilice la búsqueda de páginas en su navegador para encontrar un término rápidamente.
- Lea la definición profesional cuando necesite precisión.
- Lea la explicación cotidiana cuando la definición todavía parezca abstracta.
- Regrese a la guía vinculada antes de cambiar permisos, instalar una extensión o publicar un paquete.
Modelo, agente y harness
| Concepto | Explicación profesional | Ejemplo cotidiano |
|---|---|---|
| Modelo de IA | Un sistema estadístico que interpreta la entrada y genera texto, código u otros resultados. No recibe acceso a la computadora por sí solo. | Explicación cotidiana: el modelo es la persona que razona en un escritorio. El escritorio, las herramientas, las llaves y los registros provienen de otras partes del sistema. |
| Agent | Un rol en ejecución que combina un modelo con instrucciones, contexto, herramientas y un bucle que puede tomar varios pasos hacia una meta. | Explicación diaria: en lugar de responder una vez, el trabajador puede inspeccionar, actuar, comprobar el resultado y continuar hasta completar la tarea asignada. |
| Agent Harness | Software que coordina el modelo, herramientas, contexto, permisos, sesiones e interfaz utilizados para el trabajo Agent. | Explicación cotidiana: es el taller gestionado en torno al trabajador. Decide qué herramientas están presentes, qué puertas están cerradas y qué está escrito en el libro de registro. |
| Proveedor | Un servicio o adaptador que pone un modelo a disposición del harness y maneja su formato de solicitud y método de autenticación. | Explicación cotidiana: diferentes proveedores de electricidad pueden alimentar el mismo taller, pero cada uno tiene su propia cuenta y sus reglas de conexión. |
| Herramienta | Una capacidad con nombre que el agente puede solicitar, como leer un archivo, editar texto, ejecutar un comando o buscar una fuente. | Explicación cotidiana: una herramienta es un elemento del armario del taller. Tenerlo en la lista no siempre significa que pueda usarse sin aprobación. |
| Contexto | La información disponible para la solicitud del modelo actual, incluidas instrucciones, historial seleccionado, archivos y resultados de herramientas. | Explicación cotidiana: es el conjunto de documentos abiertos sobre el escritorio para esta decisión. No es automáticamente un recuerdo permanente de todo lo que sucedió. |
Cómo se organiza el trabajo
| Concepto | Explicación profesional | Ejemplo cotidiano |
|---|---|---|
| Espacio de trabajo | La ubicación del proyecto que sirve como directorio de trabajo y referencia para organizar tareas. Seleccionarla no establece por sí sola una frontera de seguridad. | Ejemplo cotidiano: la dirección en una orden de trabajo. Las cerraduras y las reglas de acceso dependen del ejecutor y de los permisos configurados. |
| Sesión | Un registro duradero de mensajes, resultados del modelo, actividad de herramientas y estado de una línea de trabajo continua. | Explicación cotidiana: es el cuaderno de bitácora del proyecto que permite regresar más tarde y comprender lo discutido y realizado. |
| Turno | El ciclo de respuesta completo desencadenado por una entrada de usuario admitida, que posiblemente contenga varios pasos de modelo y herramienta. | Explicación diaria: una solicitud en la mesa de servicio puede requerir varias acciones internas antes de que la respuesta final esté lista. |
| Paso | Una solicitud de modelo y las llamadas de herramienta que siguen dentro de un turno. | Explicación diaria: es un elemento de la lista de verificación del trabajador, mientras que el turno completo es la solicitud completa. |
| Complemento | Una unidad de software cargable que aporta servicios, eventos, herramientas, partes de interfaz u otro comportamiento al Harness. | Explicación cotidiana: es un módulo homologado añadido al taller, como una máquina nueva o un panel de control. |
| Perfil | Una composición con nombre que determina qué paquetes, complementos y capas de configuración comienzan juntos. | Explicación cotidiana: es una configuración de taller guardada para un tipo de trabajo particular. DeepSeek Harness envía plantillas para la interfaz web y para ejecución sin interfaz. |
| Habilidad | Un conjunto reutilizable de instrucciones y recursos de apoyo que enseña a un agente cómo llevar a cabo un flujo de trabajo limitado. | Explicación cotidiana: es una tarjeta de trámite revisada. Guía al trabajador, pero no concede silenciosamente nuevos permisos informáticos. |
| Tiempo de ejecución | El proceso de software real, las versiones de dependencia, la configuración y el entorno operativo en el que se ejecuta una tarea. | Explicación cotidiana: una receta puede ser idéntica pero la cocina real es diferente. La verificación debe realizarse en la cocina que realmente se utilizará. |
| Diferencia | Una comparación estructurada que muestra cómo los archivos o el texto difieren entre dos estados sin aplicar ninguno de los estados por sí solo. | Explicación cotidiana: es una hoja de antes y después con líneas cambiadas resaltadas. Al leerlo no se aceptan los cambios. |
| Gancho | Un activador configurado que ejecuta una acción definida antes, después o durante un evento con nombre en una herramienta o flujo de trabajo. | Explicación cotidiana: es un timbre conectado a una respuesta específica. Dado que la respuesta puede ejecutar código, revise su fuente y sus permisos. |
| MCP | Protocolo de contexto modelo, una forma estándar para que un agente o Harness se conecte a herramientas y datos externos a través de un servidor MCP. | Explicación cotidiana: es un conector estándar entre el entorno de trabajo y otro servicio. Un enchufe compatible no hace que el servicio sea confiable. |
| Nube | Un entorno de ejecución remota alojado fuera de la computadora local, con sus propios archivos, credenciales, red, persistencia y límites de facturación. | Explicación cotidiana: es un espacio de trabajo alquilado en otro edificio. Verifique sus claves, almacenamiento, costos y reglas de limpieza antes de enviar trabajo allí. |
Permisos y seguridad
| Concepto | Explicación profesional | Ejemplo cotidiano |
|---|---|---|
| Permiso | Una regla que describe qué acción está permitida, denegada o sujeta a una decisión en tiempo de ejecución. | Explicación cotidiana: es la lista de acceso en una puerta. Una frase que pide a alguien que tenga cuidado no es una regla de acceso. |
| Aprobación | Una decisión humana o política solicitada antes de que se permita que continúe una acción en particular. | Explicación cotidiana: el trabajador se detiene ante un armario cerrado y pregunta antes de coger la llave. |
| Caja de arena | Un límite técnico que restringe efectos seleccionados de un proceso. Su cobertura exacta depende de la plataforma y la configuración. | Explicación cotidiana: es una zona de trabajo vallada. Aún debe verificar si la barrera cubre archivos, acceso a la red, procesos o solo una parte de ellos. |
| Credencial | Un secreto o token de identidad utilizado para autenticarse con un proveedor de modelo, servicio, repositorio u otro sistema protegido. | Explicación cotidiana: es una llave o tarjeta bancaria. Guárdelo en la configuración designada o en el almacén secreto, nunca en texto de chat o archivos de proyecto. |
| Privilegio mínimo | La práctica de otorgar solo el acceso necesario para la tarea actual y solo durante el tiempo que sea necesario. | Explicación cotidiana: entregue a un visitante la llave de la sala de reuniones, no una llave maestra de todo el edificio. |
| Revertir | Una operación preparada que restaura el estado previamente verificado después de que un cambio falla o ya no es necesario. | Explicación diaria: conserve la versión funcional anterior e instrucciones de devolución claras antes de reemplazar cualquier cosa. |
Apariencia e interfaz
| Concepto | Explicación profesional | Ejemplo cotidiano |
|---|---|---|
| Token semántico | Un valor de diseño con nombre cuyo nombre describe un propósito, como fondo o acento, en lugar de un color fijo. | Explicación cotidiana: es una etiqueta como pintura de pared o luz de advertencia. Cada tema puede proporcionar un color diferente para el mismo trabajo. |
| Tema | Un conjunto coordinado de valores de apariencia semántica, que generalmente cubre los modos claro y oscuro sin cambiar la estructura del producto. | Explicación cotidiana: cambia el plan de pintura e iluminación de la habitación dejando las paredes y los muebles en su lugar. |
| Apariencia completa | Una clase de publicación DSH Themes que combina valores semánticos con imágenes controladas y estilos generados bajo reglas de evidencia más estrictas. | Explicación cotidiana: cambia pintura, iluminación y decoración seleccionada. Es un formato de DSH Themes, no un formato nativo oficial de DeepSeek Harness. |
| Complemento | Un complemento que cambia o agrega un flujo de trabajo Harness en lugar de solo proporcionar valores de apariencia. | Explicación cotidiana: agrega un nuevo panel de control o estación de trabajo, por lo que su comportamiento y permisos importan tanto como su apariencia. |
| Transporte | La conexión que transporta solicitudes, eventos y estado entre la interfaz web y el proceso Harness en ejecución. | Explicación cotidiana: es la ruta de entrega entre la sala de control y el taller. Una página visible no prueba que la ruta esté conectada. |
Paquetes y verificación
| Concepto | Explicación profesional | Ejemplo cotidiano |
|---|---|---|
| Paquete | Una unidad de distribución versionada que contiene código, metadatos, recursos o configuración destinados a instalarse juntos. | Explicación cotidiana: es una caja de producto sellada. El nombre en el estante no es suficiente para probar qué hay exactamente dentro de esta caja. |
| Artefacto | El archivo compilado exacto que se descarga, instala, prueba o publica, como un archivo de paquete específico. | Explicación cotidiana: es la caja física que llegó, no la descripción del producto en el catálogo. |
| SHA-256 | Un resumen criptográfico utilizado como huella digital estable para los bytes completos de un artefacto. | Explicación cotidiana: las huellas dactilares coincidentes muestran que dos archivos tienen los mismos bytes. No prueban que los contenidos sean seguros o tengan la licencia adecuada. |
| Sidecar | Un registro separado legible por máquina almacenado junto a un artefacto para describir su identidad, compatibilidad, hashes o referencias de evidencia. | Explicación cotidiana: es la tarjeta de inspección adjunta a la caja. Tanto la tarjeta como la caja deben coincidir. |
| Atestación | Un registro firmado o controlado que indique qué se verificó, en qué entorno, con qué entradas exactas y con qué resultado. | Explicación cotidiana: es un informe de inspección fechado. Un informe de otro modelo o versión no puede certificar el artículo que tiene delante. |
| Línea base certificada | La versión Harness exacta y el conjunto de pruebas con los que un elemento ha completado el flujo de trabajo de verificación requerido. | Explicación cotidiana: el software ascendente actual puede ser más nuevo que la versión que finalizó la inspección. Más nuevo y certificado son hechos diferentes. |
Qué hacer cuando un término aún no está claro
- 01
Encuentra el término exacto
Copie la palabra tal como está escrita, incluido el nombre del producto cuando esté presente.
- 02
Identificar la capa
Pregunte si describe inteligencia, organización, permisos, interfaz o verificación.
- 03
Verifique el significado específico del producto
La misma palabra puede tener un significado más limitado en DeepSeek Harness, Pi, Codex u otra herramienta.
- 04
Pausa antes de una acción arriesgada
Si el término afecta el acceso, las credenciales, la instalación o la eliminación, lea la guía vinculada o la fuente oficial antes de continuar.
Continúa desde el concepto que encontraste
Entender DeepSeek HarnessVea cómo las piezas principales funcionan juntas en un solo sistema.Utilice el inicio rápido para principiantesEjecute una pequeña tarea con un límite de permiso visible.Aprenda los hábitos de trabajo más segurosAplicar privilegios mínimos, verificación y reversión en la práctica.
Práctica: de leer un archivo a verificar un cambio
Conecta los términos con un pequeño inventario: lee el archivo, comprueba un cálculo, cambia un valor y observa qué se guarda. Crea una carpeta vacía de práctica y configura el espacio de trabajo y el modelo de Harness Web con la guía de inicio.
text
item,quantity,unit_price
tea,3,12
mug,2,25
bag,1,18- 01
Elige el espacio de trabajo
Selecciona la carpeta que contiene inventory.csv. Define el directorio de trabajo; elegirla no crea por sí solo un entorno aislado para archivos o red.
- 02
Revisa la configuración activa
Comprueba el modelo y el ajuste de permisos de esta sesión. Un perfil combina complementos y configuración; no es una carpeta ni una conversación guardada.
- 03
Solicita la lectura
Envía el prompt siguiente, despliega la llamada real de lectura y su resultado y compara cada fila con tu archivo. Una respuesta bien escrita no demuestra que se haya leído.
text
Lee inventory.csv del espacio de trabajo seleccionado. Muestra quantity × unit_price y el subtotal de cada artículo, y después el total. Indica la ruta que has leído realmente y no cambies el archivo. Si no puedes acceder, explica qué herramienta o permiso falta en vez de inventar el contenido.Los subtotales esperados son tea 36, mug 50 y bag 18, con un total de 104. Esto comprueba la aritmética, no puntúa al modelo. Si hay diferencias, revisa por separado las filas de entrada, las multiplicaciones y la suma.
| Concepto | Explicación profesional | Ejemplo cotidiano |
|---|---|---|
| Espacio de trabajo | La carpeta que contiene inventory.csv. | Compara la ruta seleccionada con la utilizada en la llamada. |
| Modelo y herramienta | El modelo solicita la lectura; una herramienta registrada la ejecuta y devuelve contenido o un error. | Revisa la llamada y su resultado; la respuesta final no es un registro de ejecución. |
| Contexto | El CSV devuelto puede informar la siguiente petición al modelo. | Tras editar, pide otra lectura: el resultado anterior puede estar desactualizado. |
| Turno y paso | Tu petición inicia un turno que puede incluir varias peticiones al modelo y llamadas de herramientas. | Cuenta las llamadas observadas. Un mensaje del usuario no implica una única petición al modelo. |
| Sesión | La conversación conserva los mensajes finalizados y la actividad de herramientas. | Abre la misma sesión y revisa la lectura anterior. Eso no restaura el archivo. |
Distingue los cambios del archivo del historial de conversación
text
En inventory.csv, cambia únicamente quantity de tea de 3 a 4. Vuelve a leer el archivo guardado, muestra la línea exacta modificada y recalcula todos los subtotales y el total. Conserva las demás filas.La fila guardada debe ser tea,4,12 y el total 116. Abre tú mismo el archivo y compáralo con el ejemplo inicial. Reabrir o bifurcar una sesión no deshace los cambios del archivo. Para recuperar el ejemplo, restaura esa fila a tea,3,12 y comprueba 104. Si usas Git, revisa el diff antes de elegir qué restaurar.
- No hay llamada o no se encuentra el archivo: comprueba la carpeta y el nombre. No concedas acceso ilimitado para resolver una ruta equivocada.
- Acción bloqueada: lee el error real de aprobación o aislamiento y su alcance. El nombre del perfil y pedir «solo lectura» no imponen restricciones técnicas.
- La respuesta sigue siendo 104 tras editar: pide que lea el archivo actual y comprueba si ha reutilizado un resultado antiguo de la conversación.
Consulta la documentación oficial
Versión 0.1.3-alpha.1 de DeepSeek HarnessComprueba la etiqueta de publicación y el commit del código fuente utilizados en esta guía.README de DeepSeek Harness AlphaConsulta la definición del producto, sus límites como versión preliminar y cómo iniciar la interfaz web.Arquitectura de DeepSeek Harness AlphaRevisa cómo se organizan los complementos, perfiles, paquetes de configuración, herramientas y sesiones.Guía de la interfaz web de DeepSeek Harness AlphaConsulta cómo configurar un modelo, elegir un espacio de trabajo, iniciar una tarea y gestionar las aprobaciones.Preajustes de permisos de DeepSeek HarnessComprueba cómo se combinan el aislamiento y las aprobaciones, y qué componente aplica realmente los límites.Subsistema de Skills de DeepSeek HarnessRevisa el descubrimiento, los proveedores, la identidad, la carga y los límites de invocación de Skills.
Preguntas comunes
Antes de realizar un cambio
Respuestas sobre formatos, compatibilidad, evidencia y reversión.
¿Qué cubre esta guía?
Esta guía cubre: Arquitectura DeepSeek Harness alpha.1 y vocabulario Web UI; DSH Themes vocabulario de publicación y apariencia; Definiciones profesionales combinadas con breves explicaciones cotidianas
¿Por dónde debo empezar?
Consulta la definición de una palabra desconocida y relaciónala con su ejemplo cotidiano. Para practicar, sigue el ejercicio inventory.csv al final del artículo: leer un archivo, comprobar el total, cambiar un valor y restaurar el archivo.
¿Qué límite debo tener presente?
Una analogía es un atajo para la comprensión. No reemplaza el comportamiento exacto del producto, especialmente en lo que respecta a permisos, zona de pruebas, credenciales y compatibilidad.
¿Es un perfil un entorno limitado de sistema de archivos?
No. Un perfil determina los complementos y los ajustes que se cargan. El aislamiento de archivos y procesos depende del ejecutor activo y de la configuración del entorno aislado.
¿Una respuesta correcta demuestra que se ejecutó una herramienta?
No. Revisa la llamada real, su contenido y el propio archivo. El total esperado sirve para contrastar, pero no demuestra por sí solo el acceso al archivo.
¿Reabrir una sesión antigua restaura los archivos?
No. El historial y los archivos de trabajo son estados distintos. Revisa el archivo actual y, si hace falta, realiza una restauración explícita y comprobada.
Continuar aprendiendo
Continuar a partir de la evidencia verificada
Compare los artefactos publicados o regrese a la documentación de instalación.