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

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

Un modèle vous donne les mots. Il ne peut pas, à lui seul, s'appuyer de manière fiable sur vos données réelles, choisir l'outil adéquat et l'appeler correctement, se rétablir en cas d'échec d'appel, mener à bien une tâche en plusieurs étapes, ni laisser une trace que vous pouvez reproduire. Socialhub Harness est le moteur d'exécution d'agent d'entreprise qui prend en charge toutes ces fonctions : il transforme un modèle performant en un agent fiable.

Chaque acteur IA de Flash — 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 fournit le langage ; un environnement d'exécution fournit l'action ; un environnement d'exécution unifié fournit la gouvernance automatiquement.

Cette référence est le point de vue du développeur sur ce runtime : ce qu'il fait au moment de l'exécution, le type de définition qu'il exécute et ses axes, comment les compétences se composent en étapes exécutées, la trajectoire reproductible que chaque exécution émet dans le journal des événements et les gardes qui ne parviennent pas à tout exécuter au même endroit. Pour un aperçu de l'entreprise, consultez la Socialhub Harness page produit.

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 fournit le langage ; un environnement d'exécution fournit l'action ; un environnement d'exécution unifié fournit la gouvernance gratuitement. 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 gardes sous-jacents sont automatiques.

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.

Gouvernance gratuite : cinq gardes à sécurité intégrée

Voici les avantages d'un environnement d'exécution unifié. Étant donné que l'exécution de chaque acteur s'effectue dans un seul environnement d'exécution, le plancher de sécurité n'a pas besoin d'être fixé sur chaque agent : il s'agit d'une propriété structurelle de l'endroit unique par lequel passe toute l'action. Ces cinq gardes appartiennent au code, sont exécutés sous chaque acteur à chaque action, et aucun paramètre ne peut les désactiver. La composition d'une définition (ses compétences, outils, modèle et contexte) est à vous de configurer dans la console AI Employees ; les gardes en dessous ne le sont pas.

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 (définition complète ou action unique) peut être mis en pause instantanément. Désactivé par défaut, limité lorsqu’il est activé et arrêtable à tout moment.
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.