El entorno de ejecución que gestiona cada agente de IA.

Un modelo te proporciona el lenguaje. Por sí solo, no puede basarse de forma fiable en sus datos reales, seleccionar la herramienta adecuada y ejecutarla correctamente, recuperarse cuando falla una llamada, completar una tarea de varios pasos ni dejar una trayectoria reproducible. El Socialhub Harness es el entorno de ejecución del agente empresarial que realiza todas esas funciones: el motor de ejecución que transforma un modelo capaz en un agente fiable.

Cada actor de IA en Flash —los gestores de Marketing, Fidelización y Riesgos, el conserje de miembros y cada generador en segundo plano— es una Definición de Agente: un plano estructurado (enrutamiento del modelo, fuentes de contexto, habilidades, herramientas, cada una con un alcance, una superficie MCP, flujo de trabajo, memoria y una política de bucle) que este entorno de ejecución ejecuta. Y como cada actor se ejecuta a través de un único entorno de ejecución, la gobernanza no es un producto separado, sino una propiedad estructural de la ejecución unificada: un modelo proporciona el lenguaje; un entorno de ejecución proporciona la acción; un entorno de ejecución unificado proporciona la gobernanza de forma gratuita.

Esta referencia es la visión del desarrollador de ese tiempo de ejecución: qué hace en el momento de la ejecución, el tipo de definición que ejecuta y sus ejes, cómo se componen las habilidades en pasos ejecutados, la trayectoria reproducible que cada ejecución emite en el registro de eventos y los guardias que caen al ejecutar todo en un solo lugar. Para obtener una descripción general del negocio, consulte la Socialhub Harness página del producto.

Qué hace el entorno de ejecución

Empiece aquí, porque este es el objetivo de todo el sistema. Cuando comienza una ejecución, el entorno de ejecución Harness realiza el trabajo que un modelo de lenguaje no puede hacer por sí mismo —las cinco cosas que se describen a continuación, en orden— y el resultado es una tarea que se lleva a cabo hasta su finalización y una trayectoria que puede reproducir.

Un tipo de definición, descrito en tres ejes.

Existe un único tipo Definition para cada actor. No se bifurca por persona; se describe a lo largo de ejes ortogonales, por lo que se aplican el mismo tiempo de ejecución, registro de eventos y condiciones, independientemente de si el actor es un agente externo, un bucle interno Flash o un generador de una sola ejecución.

Resultado del entorno de ejecución: una trayectoria reproducible

Generar una trayectoria reproducible es el paso 5 del proceso de ejecución, y también constituye la evidencia de auditoría. Independientemente del actor y de cómo se ejecute, cada ejecución emite un flujo de eventos en un único registro de eventos de solo anexión. Cada evento se identifica con un ID de ejecución y la versión exacta del plano (definición) que lo generó, lo que permite auditar y reproducir una ejecución. Los tipos de eventos que emite una ejecución, ordenados, son:

Junto a estos, el tronco lleva el reflejado MCP llamadas a herramientas (cuando el actor conduce) Flash encima MCP) y el cierre resultado empresarial — de modo que la trayectoria, desde la intención hasta el resultado, reside en un solo lugar.

// one run's trajectory (abbreviated — every event carries runId + definitionVersion)
{
  "runId": "run_a1f9…",
  "definition": "loyalty-manager",
  "definitionVersion": 4,
  "events": [
    { "type": "run_started",     "at": "2026-08-26T09:14:02Z" },
    { "type": "user_intent",     "intent": "work the win-back worklist" },
    { "type": "context_loaded",  "sources": ["task", "member_rollup", "churn_signal"] },
    { "type": "model_selected",  "model": "…" },
    { "type": "prompt_assembled","skill": "winback-worklist-execution" },
    { "type": "reasoning",       "summary": "high value, at-risk, consented" },
    { "type": "permission_check","tool": "issue_coupon", "result": "allowed" },
    { "type": "tool_called",     "tool": "issue_coupon", "args": { "value": 10 } },
    { "type": "tool_result",     "ok": true },
    { "type": "cost",            "tokens": 3120, "usd": 0.04 },
    { "type": "run_ended",       "outcome": "coupon issued · within budget" }
  ]
}

Consulta la trayectoria de una carrera a través de la aplicación Flash. Busca una carrera por ID o consulta las carreras recientes:

# one run's full trajectory
GET https://flash.socialhub.ai/api/flash/agent-runs/{runId}

# list recent runs
GET https://flash.socialhub.ai/api/flash/agent-runs

Las entradas nunca se editan, solo se añaden; el registro es el historial completo de lo que hizo cada agente y por qué, reconstruible paso a paso a partir del ID de ejecución y la versión del plano.

Dónde encaja Harness con el resto de la plataforma

El Harness es el entorno de ejecución de cada agente de IA y, dado que todo pasa por él, también la capa de gobernanza. Dos referencias adyacentes describen los componentes en los que se basa:

• MCP superficie. Un actor mcp_external posee una clave con ámbito y llama a las herramientas controladas de Flash a través del Protocolo de Contexto del Modelo. El punto final, la autenticación, la configuración del cliente y el catálogo completo de herramientas se encuentran en la guía de integración MCP.
• Mecanismos de autorización y aprobaciones. El mecanismo por acción (automático/revisión/prohibido), la semántica de escritura pendiente/rechazada y el ciclo de vida de aprobación que se encuentran sobre el mecanismo de autorización están documentados en Gobernanza de la IA: Introspección y aprobaciones.