SocialHub.AI
Referencia de ingeniería · SocialHub.AI Harness

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

Un modelo le da lenguaje. No puede, por sí solo, anclarse de forma fiable en sus datos reales, elegir la herramienta correcta y llamarla bien, recuperarse cuando una llamada falla, llevar una tarea de varios pasos hasta el final, o dejar una trayectoria que pueda reproducir. SocialHub.AI Harness es el runtime de agente empresarial que hace todo eso: el motor de ejecución que convierte un modelo capaz en un agente fiable.

Cada actor de IA en SocialHub.AI —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 da el lenguaje; un entorno de ejecución da la acción; un entorno de ejecución unificado mantiene cinco protecciones de seguridad en cada ruta de acción: usted fija los topes y puede pausar las escrituras, pero no puede desactivar estas protecciones. El registro de auditoría es con el mejor esfuerzo y puede dejar huecos.

Esta referencia es la vista del desarrollador de ese runtime: qué hace en la ejecución, el tipo Definition que ejecuta y sus ejes, cómo las skills se componen en pasos ejecutados, la trayectoria reproducible que cada ejecución escribe en el registro de eventos, y las protecciones que aparecen al ejecutar todo en un solo lugar. La visión de negocio está en la página de producto de SocialHub.AI Harness.

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.

1 · Context assembly

El entorno de ejecución define el actor: recopila el brief y los datos comerciales reales (tarea, resúmenes de miembros/segmentos, kit de marca, métricas) para cada ejecución, minimizando la información personal identificable (PII). El modelo nunca adivina sus datos; se le proporcionan directamente.

2 · Model routing

El entorno de ejecución determina qué motor de razonamiento ejecuta cada paso, con alternativas, a partir de los nombres de la Definición. El enrutamiento es responsabilidad del entorno de ejecución, no del indicador.

3 · Skill composition into steps

El tiempo de ejecución inyecta los pasos ordenados de las habilidades compuestas y la guía para tomar decisiones en el mensaje, de modo que lo que se ejecuta es un procedimiento con nombre y versión, no lo que improvisó el modelo.

4 · The tool loop

El tiempo de ejecución impulsa el ciclo seleccionar-llamar-observar: elige una herramienta gobernada, verifica el permiso, la llama, lee el resultado y se recupera o escala en caso de falla: la confiabilidad de la que carece una llamada de modelo simple.

5 · A reproducible trajectory

Cada paso se emite, en orden, en el registro de eventos de solo escritura, con un ID de ejecución y la versión exacta del plano, lo que permite auditar y reproducir la ejecución paso a paso.

Un modelo da el lenguaje; un entorno de ejecución da la acción; un entorno de ejecución unificado mantiene cinco protecciones de seguridad en cada ruta de acción: usted fija los topes y puede pausar las escrituras, pero no puede desactivar estas protecciones. El registro de auditoría es con el mejor esfuerzo y puede dejar huecos. Todo lo que sigue —la definición que ejecuta el entorno de ejecución, cómo se componen las habilidades, el registro de eventos que produce y las medidas de seguridad que aplica— se deriva de estos cinco pasos que se ejecutan en un único lugar para cada actor.

Anatomía de la definición de agente: qué ejecuta el entorno de ejecución

El entorno de ejecución ejecuta una Definición: un plano estructurado (no código, ni una solicitud de formato libre) que compone las partes que se muestran a continuación. Editar cualquiera de ellas produce un nuevo plano con versión que el entorno de ejecución utiliza en la siguiente ejecución; la versión se imprime en cada evento que emite la ejecución.

Parte del planoDe qué se compone
Enrutamiento del modeloQué motor de razonamiento ejecuta cada paso y las alternativas. Nombra el modelo; el tiempo de ejecución lo resuelve.
Fuentes de contextoEl informe y los datos comerciales iniciales del agente (tarea, resumen de miembros/segmentos, kit de marca, métricas) se recopilan para cada ejecución, minimizando la información personal identificable.
HabilidadesLos manuales de procedimientos estructurados se integran en el actor (véase más abajo). Procedimientos con nombre, no indicaciones de formato libre.
HerramientasLas acciones reguladas que el actor puede realizar, cada una con un alcance. La definición nombra una herramienta; nunca la otorga. La base de datos es la autoridad.
MCP superficieQué herramientas están expuestas a través del Protocolo de contexto del modelo para un agente externo que posee una clave de alcance y bajo qué engranajes.
Flujo de trabajoLos pasos ordenados o gráficos de las unidades de tiempo de ejecución (reclamar, leer, decidir, actuar, completar) para la lista de trabajo y los actores orquestados.
MemoriaQué puede conservar el actor entre pasos y ejecuciones, y qué debe releer cada vez. Limitado, no un bloc de notas para información personal identificable.
Política de bucle.La regla de detención: pasos máximos, techo presupuestario y escalada a la condición humana. El tiempo de ejecución lo impone; el actor no puede extenderlo.

Nombra la capacidad; nunca la otorga. Una definición puede hacer referencia a una herramienta, un modelo o una fuente de datos, pero el entorno de ejecución resuelve si este espacio de trabajo y esta clave pueden usarlos realmente, consultando la base de datos en el momento de la llamada. El plano es la superficie de composición; dado que el entorno de ejecución resuelve la autoridad en un solo lugar, las protecciones inferiores se mantienen activas.

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.

AxisValoreslo que captura
runtimeFormmcp_external · server_orchestrator · inline_functionCÓMO se ejecuta la definición. mcp_external = un agente externo que posee una clave de alcance y llama a través de MCP. server_orchestrator = un bucle internoFlash que controla el tiempo de ejecución paso a paso. inline_function = un generador de disparo único invocado en el flujo de una pantalla.
agentTypeemployee · chatbot · function¿Qué significa para el negocio? Empleado = un trabajador con nombre que usted administra (objetivos, tareas, comentarios). Chatbot = una interfaz conversacional basada en datos reales. Función = un generador o clasificador de un solo propósito sin personalidad.
Tipo técnicoagent · generator · embedded · custom · workflowClasificación de ingeniería del plano: un agente compuesto de varios pasos, un generador en línea, una capacidad integrada, una definición personalizada del espacio de trabajo o un gráfico de flujo de trabajo de varios pasos.
dominio empresarialUno de los 8 dominios (derecha)A QUÉ parte del negocio presta servicios: Marketing y campañas, Lealtad y retención, Riesgo y cumplimiento, Servicio para miembros, Contenido y creatividad, Inteligencia del cliente, Análisis e información, Investigación y simulación.

Más de 40 actores controlados, un modelo. La lista de agentes activos incluye: 5 agentes compuestos (de varios pasos, orquestados por el servidor: los cuatro gestores más el asistente personal), 28 funciones en línea (generadores y clasificadores de un solo paso integrados en el producto) y 8 funcionalidades integradas (ayudantes en pantalla). Todas ellas pertenecen al mismo tipo de definición, diferenciándose únicamente en los ejes superiores.

Habilidades: manuales de estrategias autorizados para bases de datos compuestos por un agente

Una habilidad es un manual de procedimientos estructurado, almacenado en la base de datos y compuesto en el perfil de un agente de la misma manera que se le entregaría un SOP a un nuevo empleado. No es un párrafo de texto de instrucciones, sino un registro escrito con las siguientes partes:

trigger

Condición bajo la cual esta habilidad se aplica a la ejecución actual.

required state

El estado del miembro/negocio debe estar presente para que la habilidad funcione correctamente; si no está presente, falla y se cierra al usuario.

tool allowlist

El subconjunto de herramientas que el agente puede usar con esta habilidad: una limitación, nunca una ampliación, de lo que el plan ya permite.

ordered steps

El procedimiento que recorre el tiempo de ejecución, en orden.

verifier rules

Las comprobaciones que deben transmitirse al resultado antes de que el paso se considere realizado.

decision guidance

Cómo elegir, incluido cuándo MANTENER o escalar, expresado como una guía, no como una rama codificada.

En tiempo de ejecución, el tiempo de ejecución , por lo que lo que se ejecuta no es "lo que sea que se le ocurrió al modelo", sino un procedimiento con nombre y versión que su equipo puede leer y aprobar. Debido a que las habilidades tienen autoridad en la base de datos, la misma habilidad se puede componer en más de un agente y cambiarla cambia a cada agente que la usa, sin necesidad de volver a implementarla.

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:

01Ejecución iniciada02Intención del usuario03contexto cargado04Modelo seleccionado05Información recopilada06Razonamiento07Verificación de permisos08Herramienta llamada09resultado de la herramienta10Acción/Resultado11Costo12Finalización de la ejecución

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.

Cinco protecciones de seguridad en cada ruta de acción

Esta es la ganancia de un entorno de ejecución unificado. Como la ejecución de cada actor pasa por un solo entorno, el piso de seguridad no tiene que atornillarse a cada agente: es una propiedad estructural del único lugar por el que pasa toda acción. Cinco protecciones de seguridad permanecen en cada ruta de acción: usted fija los topes y puede pausar las escrituras, pero no puede desactivar las comprobaciones de cumplimiento. El registro de auditoría es con el mejor esfuerzo y puede dejar huecos. Usted configura las habilidades, las herramientas, el modelo y el contexto de una definición en la consola de empleados de IA; no retira esas comprobaciones.

GuardiaQué garantiza
Ámbito de autorización × nivel del planCada llamada a una herramienta se verifica con respecto al alcance de la clave y el nivel del plan del espacio de trabajo. La definición nombra una herramienta; la autorización para ejecutarla reside en la base de datos y se resuelve al momento de la llamada. Una herramienta a la que la clave no puede acceder simplemente se oculta.
Límites de valor de escritura + tasaLas escrituras que transfieren valor (puntos, cupones) están limitadas por un tope de valor por llamada y un límite de tasa de escritura por clave, ambos aplicados en caso de fallo en el servidor, independientemente de lo que indique la solicitud del actor o la confirmación del cliente.
Libro mayor de presupuestoCada ejecución se ejecuta dentro de un presupuesto de token + costo, precargado antes de que el actor actúe y reducido a medida que se ejecuta. Cuando el libro de contabilidad se agota, la carrera se detiene: un actor nunca puede quedarse sin gastar.
Interruptor de seguridadCualquier actor — una definición completa o una sola acción — se puede pausar al instante. Con tope cuando está activo, y detenible en el momento en que quieras detenerlo; La recuperación está activa de forma predeterminada una vez configurada para tu espacio de trabajo; puedes pausarla o desactivarla en cualquier momento; los demás actores siguen apagados hasta que se encienden.
AuditoríaCada paso se registra en el registro de eventos de solo escritura con el ID de ejecución y la versión exacta del plano. Nada de lo que haga un actor queda sin registrar, y ninguna configuración puede suprimir una entrada en el registro.

Configure la composición en /flash/agents. La consola AI Employees es donde edita las habilidades, herramientas, modelo y contexto de un actor, lo que produce un nuevo plano versionado. Lo que nunca se puede editar allí es el piso de seguridad: las cinco protecciones anteriores se aplican en código, no en configuración.

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.