SocialHub.AI
Référence technique · SocialHub.AI Harness

L’environnement d’exécution qui gère chaque IA.

Un modèle vous donne le langage. Il ne peut pas, seul, s'ancrer de façon fiable dans vos données réelles, choisir le bon outil et l'appeler correctement, se rétablir quand un appel échoue, mener une tâche à plusieurs étapes jusqu'au bout, ou laisser une trajectoire que vous pouvez rejouer. SocialHub.AI Harness est le runtime d'agent d'entreprise qui fait tout cela — le moteur d'exécution qui transforme un modèle capable en agent fiable.

Chaque acteur IA de SocialHub.AI — les responsables marketing, fidélisation et risques, le service de conciergerie des membres et chaque générateur en coulisses — est une Définition d'agent : un modèle structuré (routage, sources de contexte, compétences, outils avec leur propre portée, une MCP surface, un flux de travail, une mémoire et une politique de boucle) que ce environnement d'exécution exécute. Et comme chaque acteur s'exécute dans un seul environnement d'exécution, la gouvernance n'est pas un produit distinct ; c'est une propriété structurelle de l'exécution unifiée : un modèle donne le langage ; un environnement d'exécution donne l'action ; un environnement d'exécution unifié garde cinq garde-fous de sécurité sur chaque chemin d'action — vous fixez les plafonds et pouvez suspendre les écritures, mais vous ne pouvez pas désactiver ces garde-fous. La journalisation d'audit se fait au mieux et peut laisser des trous.

Cette référence est la vue du développeur sur ce runtime : ce qu'il fait à l'exécution, le type Definition qu'il exécute et ses axes, la façon dont les skills deviennent des étapes exécutées, la trajectoire reproductible que chaque exécution écrit dans le journal d'événements, et les garde-fous qui apparaissent quand tout tourne au même endroit. Pour la vue métier, voir la page produit SocialHub.AI Harness.

Fonctionnement du runtime lors de l'exécution

Commencez ici, car c'est le principe même du système. Au démarrage d'une exécution, l'environnement d'exécution Harness effectue les tâches qu'un modèle de langage ne peut pas réaliser seul (les cinq points ci-dessous, dans l'ordre), et le résultat est une tâche menée à terme et une trajectoire que vous pouvez reproduire.

1 · Context assembly

Le processus d'exécution ancre l'acteur : il assemble le brief et les données commerciales réelles (tâche, regroupements de membres/segments, kit de marque, indicateurs) à chaque exécution, avec une protection des données personnelles minimale. Le modèle ne devine jamais vos données ; elles lui sont fournies.

2 · Model routing

L'environnement d'exécution détermine quel moteur de raisonnement exécute chaque étape, avec des solutions de repli, en fonction des définitions. Le routage est géré par l'environnement d'exécution, pas par l'invite de commande.

3 · Skill composition into steps

L'environnement d'exécution injecte les étapes ordonnées et les instructions de décision des compétences composées dans l'invite, de sorte que ce qui est exécuté est une procédure nommée et versionnée, et non une improvisation du modèle.

4 · The tool loop

Le moteur d'exécution pilote la boucle de sélection-appel-observation : il sélectionne un outil gouverné, vérifie l'autorisation, l'appelle, lit le résultat et récupère ou escalade en cas d'échec - la fiabilité qui manque à un appel de modèle nu.

5 · A reproducible trajectory

Chaque étape est enregistrée séquentiellement dans le journal d'événements (en mode ajout uniquement), avec un identifiant d'exécution et la version exacte du modèle. L'exécution est ainsi auditable et reproductible étape par étape.

Un modèle donne le langage ; un environnement d'exécution donne l'action ; un environnement d'exécution unifié garde cinq garde-fous de sécurité sur chaque chemin d'action — vous fixez les plafonds et pouvez suspendre les écritures, mais vous ne pouvez pas désactiver ces garde-fous. La journalisation d'audit se fait au mieux et peut laisser des trous. Tout ce qui suit — la définition exécutée par l'environnement d'exécution, la composition des compétences, le journal d'événements qu'il produit et les gardes qui les maintiennent — découle de ces cinq étapes exécutées en un seul endroit pour chaque acteur.

Anatomie d'un agent : définition — ce que l'environnement d'exécution exécute

L'environnement d'exécution applique une définition : un plan structuré (ni code, ni invite libre) qui compose les éléments ci-dessous. Toute modification de ces éléments génère un nouveau plan versionné que l'environnement d'exécution reprend lors de la prochaine exécution ; la version est enregistrée pour chaque événement émis par cette exécution.

Partie de planCe qu'elle compose
Modèle de routageMoteur de raisonnement exécutant chaque étape, ainsi que les solutions de repli. Il nomme le modèle ; l’environnement d’exécution le résout.
Sources contextuellesLes informations de base (tâche, regroupement des membres/segments, identité visuelle, indicateurs) sont compilées à chaque exécution et les données personnelles sont minimisées.
CompétencesLes playbooks structurés sont composés sur l'acteur (voir ci-dessous). Procédures nommées, et non invites libres.
OutilsLes actions autorisées pour l'acteur, chacune avec son périmètre. La définition désigne un outil, mais ne l'octroie jamais. La base de données fait autorité.
Plateforme MCPQuels outils sont exposés via le protocole de contexte de modèle pour un agent externe détenant une clé de portée, et sous quels engrenages.
Flux de travailÉtapes ordonnées ou représentation graphique des processus d'exécution (réclamation, lecture, décision, action, finalisation) pour les listes de tâches et les acteurs orchestrés.
MémoireCe que l'acteur peut conserver d'une étape à l'autre et ce qu'il doit relire à chaque fois. Délimité, pas un brouillon pour les données personnelles.
Politique de boucle.La règle d'arrêt : étapes maximales, plafond budgétaire et escalade vers la condition humaine. Le moteur d'exécution l'applique ; l'acteur ne peut pas le prolonger.

Elles nomment une capacité ; elles ne l'octroient jamais. Une définition peut référencer un outil, un modèle ou une source de données, mais la possibilité pour cet espace de travail et cette clé de l'utiliser est déterminée par l'environnement d'exécution auprès de la base de données lors de l'appel. Le modèle constitue la surface de composition ; comme l'environnement d'exécution gère l'autorité en un seul endroit, les garde-fous ci-dessous restent actifs.

Un type de définition, décrit selon trois axes

Chaque acteur possède un seul type Definition. Ce type ne se duplique pas selon le profil : il est décrit le long d’axes orthogonaux. Ainsi, le même environnement d’exécution, le même journal d’événements et les mêmes gardes s’appliquent, que l’acteur soit un agent externe, une boucle interne Flash ou un générateur ponctuel.

AxisValeursCe qu'il capture
runtimeFormmcp_external · server_orchestrator · inline_functionCOMMENT la définition s’exécute. mcp_external = un agent externe détenant une clé de portée, appelant sur MCP. server_orchestrator = une boucle in-Flash que le runtime pilote étape par étape. inline_function = un générateur mono-coup invoqué dans le flux d'un écran.
agentTypeemployee · chatbot · functionQu'est-ce que cela représente pour l'entreprise ? Employé : un collaborateur nommé que vous gérez (objectifs, tâches, retours). Chatbot : une interface conversationnelle basée sur des données réelles. Fonction : un générateur ou un classificateur à usage unique, sans persona.
Type techniqueagent · generator · embedded · custom · workflowClassification technique du plan directeur : agent composé en plusieurs étapes, générateur intégré, fonctionnalité embarquée, définition personnalisée de l’espace de travail ou graphe de flux de travail en plusieurs étapes.
domaine d'activitéUn des 8 domaines (à droite)Secteur d'activité concerné : Marketing et Campagnes, Fidélisation et Rétention, Risques et Conformité, Service Client, Contenu et Création, Connaissance Client, Analyse et Perspectives, Recherche et Simulation.

Plus de 40 acteurs gérés, un seul modèle. La liste active comprend 5 agents composés (multi-étapes, orchestrés par le serveur : les quatre gestionnaires et le concierge membre), 28 fonctions intégrées (générateurs et classificateurs ponctuels déployés dans le produit) et 8 fonctionnalités intégrées (assistants de flux affichés à l’écran). Chacune d’elles est du même type de définition et ne diffère que selon les axes mentionnés ci-dessus.

Compétences : playbooks faisant autorité sur une base de données composés sur un agent

Une compétence est un playbook structuré , stocké dans la base de données et intégré au profil de l'agent, à la manière d'une procédure opérationnelle standard (POS) remise à un nouvel employé. Il ne s'agit pas d'un paragraphe de texte d'instructions, mais d'un enregistrement dactylographié contenant les éléments suivants :

trigger

Conditions d'application de cette compétence pour l'exécution actuelle.

required state

L’état du membre/de l’entreprise est indispensable au bon fonctionnement de la compétence ; en son absence, elle ne peut être utilisée par un utilisateur.

tool allowlist

Le sous-ensemble des outils de l'agent que cette compétence peut utiliser — un rétrécissement, jamais un élargissement, de ce que le plan directeur autorise déjà.

ordered steps

La procédure que le runtime parcourt, dans l'ordre.

verifier rules

Les contrôles qui doivent transmettre le résultat avant que l'étape soit considérée comme terminée.

decision guidance

Comment choisir – y compris quand MAINTENIR ou escalader – exprimé sous forme de conseils et non de branche codée en dur.

Au moment de l'exécution, le moteur d'exécution  ; ce qui s'exécute n'est donc pas « quel que soit le modèle proposé », mais une procédure nommée et versionnée que votre équipe peut lire et approuver. Étant donné que les compétences font autorité au niveau de la base de données, la même compétence peut être composée de plusieurs agents, et sa modification modifie chaque agent qui l'utilise, sans redéploiement.

Résultat de l'exécution : une trajectoire reproductible

La génération d'une trajectoire reproductible est la cinquième étape du processus d'exécution, et elle constitue également votre preuve d'audit. Quel que soit l'acteur et son mode d'exécution, chaque exécution génère un flux d'événements dans un seul Journal des événements en mode ajout uniquementChaque événement est estampillé d'un ID d'exécution et le version exacte du plan (définition) qui l'a produit — une exécution est donc auditable et reproductible. Les types d'événements ordonnés qu'une exécution émet :

01Lancement02Intention de l'utilisateur03Contexte chargé04Modèle sélectionné05Projet assemblé06Justification07Vérification des autorisations08outil appelé09résultat de l'outil10Action/Résultat11Coût12Exécution terminée

En plus de cela, le journal contient les appels d'outils miroirs MCP (lorsque l'acteur conduit Flash sur MCP) et le résultat commercial final — ainsi la trajectoire, de l'intention au résultat, réside en un seul endroit.

// 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" }
  ]
}

Consultez l'historique d'une course via l'application Flash. Retrouvez une course par son identifiant ou consultez la liste des courses récentes :

# 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

Les entrées ne sont jamais modifiées, seulement complétées ; le journal constitue l'historique complet des actions de chaque acteur et de leurs raisons, reconstituable étape par étape à partir de l'identifiant d'exécution et de la version du modèle.

Cinq garde-fous de sécurité sur chaque chemin d'action

Voici le gain d'un environnement d'exécution unifié. Comme l'exécution de chaque acteur passe par un seul environnement, le plancher de sécurité n'a pas à être boulonné sur chaque agent — c'est une propriété structurelle de l'unique endroit par où passe toute action. Cinq garde-fous de sécurité restent sur chaque chemin d'action — vous fixez les plafonds et pouvez suspendre les écritures, mais vous ne pouvez pas désactiver les contrôles d'application. La journalisation d'audit se fait au mieux et peut laisser des trous. Vous configurez les compétences, les outils, le modèle et le contexte d'une définition dans la console Employés IA ; vous ne retirez pas ces contrôles.

GardeCe que cela implique
Étendue de l'autorisation × niveau d'abonnementChaque appel d'outil est vérifié par rapport à la portée de la clé ET au niveau de planification de l'espace de travail. La définition nomme un outil ; l'autorisation de l'exécuter réside dans la base de données et est résolue lors de l'appel. Un outil inaccessible via la clé est simplement masqué.
Plafonds de valeur d'écriture + tauxLes écritures génératrices de valeur (points, coupons) sont soumises à un plafond de valeur par appel et à une limite de débit d'écriture par clé. Ces deux limites sont appliquées avec une fermeture automatique en cas de défaillance côté serveur, indépendamment de toute affirmation de l'utilisateur ou de la confirmation côté client.
Grand livre budgétaireChaque exécution s'exécute dans le cadre d'un budget jeton + coût, préchargé avant que l'acteur n'agisse et tiré au fur et à mesure de son exécution. Lorsque le registre est épuisé, la course s’arrête – un acteur ne peut jamais s’enfuir avec des dépenses.
Coupure d'arrêt d'urgenceTout acteur — une définition entière ou une seule action — peut être mis en pause instantanément. Plafonné lorsqu'il est actif, et arrêtible dès que vous voulez l'arrêter ; La reconquête est activée par défaut une fois qu'elle est configurée pour votre espace de travail ; vous pouvez la mettre en pause ou la désactiver à tout moment ; les autres acteurs restent inactifs jusqu'à ce qu'on les active.
AuditChaque action est consignée dans le journal d'événements (en mode ajout uniquement) avec l'identifiant d'exécution et la version exacte du plan. Aucune action d'un acteur n'est omise et aucun paramètre ne permet de supprimer une entrée du journal.

Configurez la composition dans /flash/agents. La console AI Employees est l'endroit où vous modifiez les compétences, les outils, le modèle et le contexte d'un acteur, produisant ainsi un nouveau plan versionné. Ce que vous ne pouvez jamais modifier ici, c'est le plancher de sécurité : les cinq protections ci-dessus sont appliquées dans le code et non dans la configuration.

Où le Harness s'adapte au reste de la plateforme

La Harness est l'environnement d'exécution de chaque acteur d'IA et, puisque tout y transite, la couche de gouvernance également. Deux références adjacentes détaillent les éléments qui la composent :

  • MCP surface. Un acteur mcp_external détient une clé à portée limitée et appelle les outils gérés par Flash via le protocole de contexte de modèle. Le point de terminaison, l'authentification, la configuration client et le catalogue complet d'outils se trouvent dans le guide d'intégration MCP.
  • Mécanismes d'autorisation et d'approbation. Le mécanisme par action (automatique/examen/interdit), la sémantique des écritures en attente/refusées et le cycle de vie des approbations qui sous-tendent le système d'autorisation sont documentés dans Gouvernance de l'IA : Introspection et approbations.