Les harnais agents exécutent le travail. UAI enregistre les preuves portables.Utilisez ce guide lorsqu’une équipe décide comment exploiter l’ingénierie, l’orchestration, les outils, la mémoire, l’observabilité, la politique, l’évaluation et la surveillance humaine doivent s’adapter à UAI-1, à la mémoire IA et au transfert de projet.
Qu’est-ce qu’un harnais agent
Un harnais agent est la couche logicielle autour des modèles et des agents qui transforme l’intention en travail contrôlé. Il peut acheminer des tâches, appeler des outils, lire des données, coordonner des agents, appliquer des politiques, collecter des approbations, conserver la mémoire d’exécution, observer des traces et décider quand un humain doit intervenir.
- Exécution:modèles, outils, flux de travail, tentatives, interruptions et état des tâches.
- Connectivité:API, sessions d’outils/ressources de style MCP, adaptateurs locaux et stratégies d’accès aux données.
- Coordination:transferts d’exécution, délégation d’agent de style A2A, tableaux de tâches et points de contrôle d’approbation.
- Mémoire:état d’exécution de courte durée, mémoire IA durable, fichiers de transfert de projet et archives wiki froides.
- Preuve:traces, décisions, résultats du validateur, paquets de versions, résumés de transfert et documents publics expurgés.
Modèle opérationnel d’ingénierie de harnais
L’ingénierie du harnais est la boucle opérationnelle pratique autour du runtime: préparer un pack de spécifications limité, exécuter le travail dans le harnais, examiner les artefacts, puis réécrire uniquement la mémoire et les preuves acceptées.
| Étape | Travaux d’ingénierie de harnais | UAIX transfert ou sortie de preuves |
|---|---|---|
| Préparer | Assemblez les fichiers de transfert de projet actuels, la mémoire IA, les contraintes, le résumé de page, les critères d’acceptation et le plan de test. | Un paquet de démarrage compact qui nomme l’autorité source, les limites de prise en charge, les routes cibles et les vérifications ciblées. |
| Courir | Laissez le runtime choisir les outils, appeler les ressources MCP, coordonner les agents, collecter les approbations, suivre les traces et exécuter des évaluations. | Pas de réclamation publique automatique. UAIX reste en dehors du chemin de contrôle en direct, sauf si l’application utilise déjà un enregistrement UAI validé. |
| Revoir | Séparez les artefacts acceptés des traces brutes, des invites masquées, des journaux privés, des tentatives infructueuses et de l’optimisation spéculative. | Résumés révisés, expurgations, résultats du validateur, résultats de tests ou d’évaluation et limites explicites de non-revendication. |
| Répondre | Promouvez uniquement les faits que les futurs humains ou agents devraient charger. | Mises à jour du projet Handoff, modifications de la mémoire IA, notes de version, état de la feuille de route, mesures d’adoption, résumés de pages et actions suivantes. |
Les résumés de pages, les points de contrôle d’intégration, les résumés d’évaluation, les mesures d’adoption et les décisions de flux de travail peuvent améliorer UAIX.org lorsqu’ils sont examinés. Les traces brutes, les invites masquées, les journaux privés, l’optimisation spéculative et les plans de nettoyage en arrière-plan doivent rester dans le harnais, le suivi des problèmes ou la mémoire froide jusqu’à leur promotion.
Où UAI correspond
UAI ne doit pas entrer en concurrence avec le harnais. UAI-1 est le contrat public d’échange et de preuves qui préserve la partie d’un agent géré qu’une autre équipe, fournisseur, version, auditeur, client ou futur agent doit être en mesure d’inspecter et de reporter.
| Exploiter le domaine stratégique | Le harnais possède généralement | UAI devrait préserver |
|---|---|---|
| Planification et orchestration | Décomposition des tâches, sélection de modèles, séquençage des outils, tentatives et comportement d’interruption. | L’intention examinée, l’état de la tâche, le résultat et le résumé du transfert face à la version. |
| Accès aux outils et aux données | MCP sessions, clients API, informations d’identification, adaptateurs locaux et application de l’accès aux données. | Preuves de demande/résultat expurgées, références de source, provenance et enregistrements de charge utile prêts à être validés. |
| Coordination d’agent à agent | Comportement de découverte, de délégation, de routage de capacités et de transfert d’exécution de style A2A. | Déclarations de capacités, instantanés de l’état des tâches, résumés de transfert de responsabilités et paquets d’échange durables. |
| Mémoire et contexte | Mémoire d’exécution, état de conversation, magasins de vecteurs et stratégie de cache local de l’outil. | Paquets de mémoire IA, fichiers Project Handoff, contraintes actives, décisions, propriétaires, contrôles et règles de promotion. |
| Observabilité et évaluation | Traces, étendues, métriques, exécutions d’évaluation, événements d’approbation et tableaux de bord de comportement. | Seuls les identifiants et résumés révisés et expurgés sont nécessaires pour reproduire, citer ou vérifier le dossier public. |
| Politique et gouvernance | Garde-corps, portes d’approbation humaine, contrôles des données et politique de déploiement. | Limites des revendications de support, preuves du validateur, matériel du pack de conformité et liens de piste de publication datés. |
Compétences d’agent et preuves UAI-1
Lorsque le package de procédures réutilisables constitue le sujet principal, utilisez leUAIX / UAI-1 Pack de compétences d’agentguide. Ce guide de harnais garde la répartition des couches visible: les compétences d’agent gèrent le chargement de procédures réutilisables; UAI-1 gère les preuves publiques portables.
Boucle d’architecture de référence
Considérez UAI comme la couche d’enregistrement autour d’une exécution, et non comme la boucle d’exécution elle-même. Une bonne architecture agentique peut utiliser UAI avant le début du travail, pendant son exécution et après son acceptation.
| Moment | Tâche d’exécution ou d’exploitation | UAIX travail |
|---|---|---|
| Avant la course | Chargez les instructions de tâche, choisissez des modèles, exposez les outils, définissez les approbations et préparez la mémoire d’exécution. | Chargez le transfert du projet, les contraintes actuelles, l’autorité source, les règles de preuve et le profil UAI-1 qui recevra une preuve publique si l’exécution réussit. |
| Pendant la course | Exécutez des étapes, appelez des outils, coordonnez des agents, collectez des traces, demandez l’approbation humaine et gérez les interruptions. | Gardez UAI hors du chemin de contrôle en direct, sauf si un enregistrement d’échange validé fait déjà partie de la conception de l’application. |
| Porte d’examen | Séparez les sorties acceptées des traces brutes, des données privées, des tentatives rejetées et des réclamations non prises en charge. | Rédigez, résumez, sélectionnez les références des sources, attachez la provenance et décidez quels faits peuvent être promus en toute sécurité. |
| Après acceptation | Conservez les modifications d’implémentation, les notes de déploiement, les résultats d’évaluation ou les résultats destinés aux clients dans le système propriétaire. | Rédigez l’enregistrement UAI-1 durable, les preuves du validateur, le paquet de conformité ou d’adoption, la mise à jour de la mémoire IA et le résumé du transfert du projet que les futurs agents et réviseurs pourront charger. |
Que devrait laisser le harnais
Toutes les lignes de trace, invites, résultats d’outils ou événements d’approbation ne doivent pas devenir des preuves UAI. Promouvez uniquement le plus petit enregistrement révisé dont une autre partie a besoin en dehors de la session d’exécution.
| Question | Si oui | Si non |
|---|---|---|
| Une autre équipe, fournisseur, version, auditeur, client ou futur agent devra-t-il valider ce fait? | Envisagez un enregistrement UAI-1, un résultat du validateur ou une mise à jour du transfert de projet. | Conservez-le dans les journaux d’exécution, l’historique des problèmes ou les enregistrements opérationnels privés. |
| Le fait soutient-il une mise en œuvre publique ou une revendication de soutien? | Joignez des preuves de schéma, de registre, d’exemple, de validateur, de conformité, de feuille de route et de journal des modifications avant la publication. | Conservez-le comme arrière-plan interne ou comme travail planifié. |
| Inclut-il des secrets, des informations d’identification, des données client, des approbations brutes, des invites cachées ou des traces privées? | Ne le publiez pas. Rédigez d’abord, puis conservez uniquement le pointeur des preuves examinées si nécessaire. | Il peut encore nécessiter un examen des sources et une vérification des limites du support avant la promotion. |
| Est-ce la vérité du projet actuel que le prochain agent doit charger? | Promouvez-le dans la mémoire IA, le transfert de projet ou les enregistrements .uai saisis après examen. |
Archivez-le sous forme d’historique source ou de mémoire froide plutôt que de contexte de démarrage. |
Modèles d’intégration courants
La plupart des équipes n’ont pas besoin de commencer par créer une nouvelle intégration d’exécution. Commencez par le modèle présentant le risque le plus faible qui crée des preuves utiles, puis passez aux adaptateurs uniquement une fois que les montages publics et les preuves de publication existent.
| Modèle | Utilisez-le quand | Comment UAI participe | Limite |
|---|---|---|---|
| Sidecar de preuves | Le harnais fonctionne déjà, mais le résultat nécessite un enregistrement portable. | Utilisez les exemples UAI-1, la sortie du validateur, les références sources et un court paquet de résultats révisés à côté de l’artefact d’exécution. | UAI observe et enregistre après examen; il ne pilote pas la boucle d’exécution. |
| Enregistrement de la porte de sortie | Une fonctionnalité, une implémentation ou une revendication publique doit être prouvée avant publication. | Joignez les charges utiles UAI-1, les preuves du validateur, le matériel de conformité ou d’adoption, l’état de la feuille de route et les liens du journal des modifications à la décision de publication. | Un paquet réussi constitue une preuve de ce paquet et de sa portée nommée, et non d’une certification ou d’une approbation. |
| Transfert du référentiel | Les futurs humains ou agents doivent continuer le travail sans historique de discussion privé. | Mettez à jour la mémoire IA, le transfert de projet, AGENTS.md, readme.human et les enregistrements .uai saisis avec les faits acceptés, les contrôles, les bloqueurs et les actions suivantes. |
Les fichiers de transfert sont de la mémoire de projet et non une preuve de conformité UAI-1 en eux-mêmes. |
| Laboratoire de montage de ponts | Une équipe souhaite une future prise en charge de MCP, A2A, de trace ou d’adaptateur d’exécution. | Créez de petits appareils rédigés, les mappages attendus, les attentes du validateur, les limites du support et les propriétaires de maintenance avant de nommer le support. | Les travaux de pont restent planifiés ou en cours de recherche jusqu’à ce que UAIX publie les appareils, les tests et la piste de publication. |
Première épreuve
Une première exécution de preuve utile est intentionnellement petite: un résultat d’exécution, un profil UAI-1, une charge utile rédigée, un résultat de validateur, un propriétaire, une destination de version ou de transfert et une limite explicite de non-revendication.
- Choisissez l’enregistrement:nommez la demande, la réponse, l’état de la tâche, l’instruction de capacité ou l’enregistrement d’erreur qui doit survivre à l’exécution.
- Sélectionnez le profil public:connectez l’enregistrement au schéma UAI-1 actuel, à l’entrée de registre, à l’exemple ou au dispositif de conformité qui s’applique réellement.
- Rédiger avant validation:supprimez les secrets, les données client, les approbations brutes, les invites masquées et les traces privées avant que la charge utile ne quitte le harnais.
- Validez et citez:conservez ensemble le résultat du validateur, la charge utile du luminaire, la portée de l’implémentation et la version datée ou la note de transfert.
- Réécrire la mémoire acceptée:mettez à jour Project Handoff uniquement avec les faits qu’un futur agent doit charger et laissez les détails bruts de la trace dans le runtime ou l’archive propriétaire.
- Nommez la limite:indiquez ce que la preuve ne prétend pas, en particulier la certification, l’approbation, la prise en charge officielle de l’adaptateur, SDK, CLI, la synchronisation automatique ou la conformité générale.
Choix stratégiques
- Conservez UAI hors exécution:laissez les harnais exécuter le travail pendant que UAI enregistre les échanges durables, les preuves et le matériel de transfert.
- Commencez par une seule épreuve:choisissez un profil UAI-1, une charge utile de candidat, un résultat de validateur et un propriétaire d’enregistrement avant de discuter de la prise en charge étendue de la plateforme.
- Cartographier les traces comme preuves seulement après examen:les traces sont une matière première utile, mais les archives publiques doivent contenir des faits expurgés, sélectionnés et reproductibles.
- Utilisez AI Memory pour connaître la vérité sur le projet actuel:Les fichiers Project Handoff et typés
.uaidoivent contenir des contraintes, des décisions, des progrès et des contrôles acceptés, et non des traces d’exécution complètes. - Gardez le langage de transition prévu jusqu’à ce qu’il soit prouvé:les adaptateurs de référence, les exportateurs de traces, la validation locale, les lints de rédaction, les SDK, les CLI et les formulations de conformité nécessitent des accessoires et des preuves de publication avant de devenir des revendications de support.
Profils de pont à prouver ensuite
Les travaux futurs utiles ne constituent pas un remplacement générique du harnais. Il s’agit d’un petit ensemble de ponts de preuves qui prouvent comment une exécution terminée peut devenir un enregistrement UAI portable sans divulguer de secrets, sans réclamer trop de support ou sans dépendre d’un seul environnement d’exécution.
| Idée de pont | Des preuves sont nécessaires en premier | Statut public |
|---|---|---|
| Exportation de trace vers UAI | Exemples de traces, règles de rédaction, charges utiles des appareils et attentes du validateur. | Travaux de preuve prévus. |
| MCP paquet de preuves d’appel d’outil | Cartographie des demandes/résultats d’outils, références de capacités, provenance et filtrage de sécurité. | Travaux de preuve prévus. |
| A2A paquet de transfert d’état de tâche | Déclaration de capacité, propriétaire de la tâche, statut de la tâche, limite de délégation et récapitulatif des résultats. | Travaux de preuve prévus. |
| Réécriture du projet Handoff | Décisions acceptées, fichiers modifiés, vérifications exécutées, bloqueurs et actions suivantes écrites dans les fichiers de transfert actuels. | Modèle actuel; l’automatisation reste prévue. |
| Charpie de validation et de rédaction locale | Règles pour les secrets, les données privées, les réclamations non fondées et les preuves de sécurité publique. | Travaux de preuve prévus. |
Limite de support actuelle
- La prise en charge actuelle de UAIX est le dossier public publié:UAI-1, Validateur, Paquet de conformité, Mémoire IA, Transfert de projet, Référence API, et les pistes de mise en œuvre publiées.
- Ce guide est un guide de stratégie et d’adoption. Il ne crée pas de harnais d’exécution, d’importateur hébergé, de planificateur, SDK, CLI, d’adaptateur officiel, de certification, d’approbation, de programme de conformité, d’écrivain de référentiel automatique, de synchronisation wiki automatique LLM ou de déclaration de conformité UAI-1 pour les fichiers de transfert locaux.
- Lorsque le travail d’exploitation agentique devient une preuve publique, joignez les résultats du validateur, les charges utiles des appareils, la portée de la mise en œuvre, les notes de version et l’état de la feuille de route avant de répéter la réclamation.
Ne réclamez pas
- Ne prétendez pas que UAIX exécute des agents, remplace les environnements d’exécution d’agent ou possède un flux de contrôle d’appel d’outils en direct.
- Ne revendiquez pas la prise en charge officielle de MCP, A2A, OpenAI, du fournisseur, SDK, CLI ou de l’adaptateur de harnais jusqu’à ce que des appareils publics, des outils et des preuves de version existent.
- Ne traitez pas les traces d’exécution, les tableaux de bord privés, les fichiers bruts supprimés, les anciens rapports ou la mémoire froide AIWikis comme des preuves de support public actives jusqu’à ce qu’elles soient examinées et promues.
- Ne placez pas de secrets, d’informations d’identification, de données privées de clients, d’opérations privilégiées, d’approbations brutes ou de traces non expurgées dans des enregistrements portables UAI, AI Memory ou Project Handoff.
Parcours de lecture pratique
- LireAjustement aux normespour décider si UAI-1, MCP, A2A, l’observabilité ou le harnais est propriétaire de la tâche immédiate.
- UtiliserUAI-1, leValidateur, etPaquet de conformitélorsque la course a besoin de preuves d’échange public.
- UtiliserMémoire IA, leAssistant de paquet de mémoire IA, etTransfert de projetlorsque le résultat durable est le contexte du projet que les futurs humains et agents devraient charger.
- UtiliserOpenAI/Codex, Agents de codage, etBudget contextueldes conseils lorsque le problème est lié à la récupération du temps d’exécution de l’agent, au transfert multi-outils ou à la maintenance de la mémoire chaude/froide.
- UtiliserFeuille de routeavant de décrire les profils de pont, les exportateurs de traces, les peluches de rédaction, les adaptateurs de référence, les SDK, les CLI ou le langage de conformité comme prise en charge actuelle.
Enregistrements UAIX associés
- Harnais de recherche pour les agents auto-apprenantsTransformez les leçons d’exploitation en mémoire .uai révisée, en registres de preuves, en notes de reproductibilité et en balayages d’exhaustivité statique.
- Ajustement aux normesPropriété des couches pour UAI-1, MCP, A2A, observabilité et preuves de pont.
- UAI-1Le contrat public actuel d’échange et de preuves.
- Transfert de projetMémoire de projet durable qui survit à l’exécution.
- Mémoire IAContexte compact accepté pour les humains et les agents.
- Guide OpenAI/CodexLe runtime exécute les agents; Project Handoff préserve la mémoire du projet.
- Guide des agents de codageUn ensemble local sur de nombreuses surfaces d’agents de codage.
- Guide budgétaire contextuelGardez le contexte de transfert à chaud compact pendant que l’ancien historique se déplace vers la mémoire froide.
- Feuille de routeLes preuves s’accumulent avant que les futures idées de ponts ne deviennent des allégations de soutien.