UAI-1 est la norme publique actuelle de messages pour une communication IA-à-IA structurée.
UAIX marque de bouclier Charte publique d'interopérabilité UAIX.org Échange universel d'intelligence artificielle Publication publique de normes
Actuel UAI-1
  • Version actuelle UAI-1
  • Définition en langage clair Format de message ouvert pour un échange IA-à-IA auditable
  • Attribution actuelle Michael Joseph Kappel, MCP
  • Commencer ici Démarrage, Transfert de projet, UAI-1, validateur, feuille de route et journal des changements

Guides

GET-Modèle d'action

Requis pour la configuration de secours idempotente limitée GET pour les clients L0/L1, distinct de l'accès minimal et ne remplace pas les points de terminaison POST JSON.

  • Dossier UAIX-DOC-2722
  • Chemin /fr-fr/guides/get-action-pattern/
  • Utilisation Dossier public canonique

Statut du document

Page des normes publiques Publié le UAIX dans le cadre du dossier actuel des normes publiques
Code
UAIX-DOC-2722
Surface
Guides
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez ce guide uniquement pour les solutions de secours idempotentes limitées GET, avec consentement, limites de débit, auditabilité, aucun secret de chaîne de requête, solution de repli live-GET et un chemin POST correspondant pour les clients capables.

Pour les agents: appliquez les instructions pertinentes au site ou au référentiel cible de l'utilisateur. Ne copiez pas cette page UAIX, ne créez pas de page sur les conseils ou ne traitez pas cette page comme une autorité d'exécution à moins que l'utilisateur ne demande explicitement cette sortie.

GET-Action est une solution de secours limitée en écriture pour les clients qui ne peuvent créer que de simples URLs.Il est distinct de l’accès minimal et ne remplace pas les API POST JSON.

Modèle d’itinéraire

Exemple de code
GET /api/{version}/{resource}/{action}?param1=value&idempotency_key=stable-key

Compagnon requis

Chaque point de terminaison GET-Action qui peut changer d’état doit avoir un point de terminaison POST correspondant pour les clients L2 et supérieurs. Le chemin POST possède des corps de requête plus riches, des erreurs structurées, des flux d’authentification et un comportement d’API ordinaire.

Contrôles requis

  • Idempotence:chaque GET-Action compatible en écriture nécessite un idempotency_key stable.
  • Consentement:l’action doit être de sécurité publique ou explicitement approuvée par l’homme avant son exécution.
  • Auditabilité:stockez l’action normalisée, la classe d’appelant, le résultat, l’horodatage, la clé d’idempotence et les preuves de sécurité publique.
  • Limites de taux:appliquez des limites sécurisées aux robots d’exploration et résistantes aux abus avant l’exécution de l’action.
  • Robots et chenilles:gardez les actions en dehors des plans de site et refusez l’exécution déclenchée par le robot lorsque cela est possible.
  • Solution de secours en direct GET:si l’action URL nécessite une dynamique en direct HTTP GET, fournissez une opération sans opération ou examinez URL pour les récupérateurs indexés uniquement.
  • Aucun secret dans les chaînes de requête:ne placez jamais de jetons, de mots de passe, de clés API, d’identifiants de patients, de messages privés ou de données de paiement dans le URL.

Forme de réponse

Exemple de code
{
  "status": "accepted",
  "action_executed": false,
  "resource_id": "public-record-id",
  "machine_data": {},
  "human_readable_url": "https://example.org/review/action/",
  "next_actions": ["human_review_required"]
}
Format de transfertOptimisé (sans clé) JSON
Exemple de code
[]

L'ordre des champs suit l'exemple de clé JSON, l'ordre du schéma publié et le registre de champs public.

Utilisation autorisée

  • Actions simples de préférence de sécurité publique, d’accusé de réception, de demande de révision ou d’admission en file d’attente lorsque POST n’est pas disponible pour le client.
  • Des actions qui peuvent être répétées en toute sécurité avec la même clé d’idempotence.
  • Actions qui ne révèlent aucun identifiant secret, réglementé, financier, médical ou privé dans le URL.

Utilisation interdite

  • Paiements, modifications de compte, actions destructrices, publication, écritures irréversibles, actions médicales ou opérations réglementées sans chemin POST authentifié plus fort et examen explicite.
  • Tout point de terminaison qui dépend d’un secret de chaîne de requête.
  • Toute affirmation générale selon laquelle les actions inscriptibles devraient généralement être exposées en tant que points de terminaison GET.

Enregistrements associés

Limite

Les environnements d’exécution de l’agent s’exécutent. UAIX enregistre la communication examinée, la mémoire, la confiance, les preuves et la limite de transfert.

  • L’accès minimal est en lecture seule, sécurisé pour le public, GET uniquement, URL uniquement et ne doit pas muter d’état.
  • GET-Action est une solution de secours limitée distincte pour les actions limitées et ne doit pas être traitée comme un remplacement des API POST JSON.
  • UAIX ne certifie pas la sécurité d’exécution, la vérité, la conscience, l’autorisation, l’adéquation médicale ou l’état de préparation à la production.

Compagnons lisibles par machine

Modèle opérationnel de communication des agents

Les environnements d’exécution de l’agent s’exécutent. UAIX enregistre la communication examinée, la mémoire, la confiance, les preuves et la limite de transfert.

UtiliserModèle opérationnel de communication des agentslorsqu’un opérateur humain, un agent de codage, un agent d’IA ou un implémenteur d’exécution a besoin d’une identité portable, d’une intention, d’un contexte, d’un accusé de réception, d’un statut, d’un bloqueur, d’une proposition de mémoire, d’une preuve de validation, d’une correction, d’un rapport final ou d’enregistrements de transfert. Les ressources lisibles par machine correspondantes sont publiées viaSchémas, Registre, Exemples, et leValidateur.

  • UAIX ne fournit pas de synchronisation automatique, de messagerie hébergée, d’orchestration d’exécution, d’adaptateurs officiels, d’exécution d’écriture dans le référentiel, d’autorité de certification ou de mécanismes d’importation hébergés.
  • Carcinus.org est un exemple d’exécution/orchestrateur distinct qui peut consommer des enregistrements UAIX. UAIX.org n’implémente pas le comportement d’exécution Carcinus et n’exécute pas les workflows Carcinus.
  • LocalEndPoint et d’autres environnements d’exécution peuvent consommer les enregistrements UAIX publiés en tant que consommateurs externes; UAIX.org n’implémente pas ses fonctionnalités d’exécution spécifiques au projet.
  • Les propositions de mémoire durable restent séparées des enregistrements d’exécution de tâches. Ne faites pas la promotion de statuts de point de terminaison temporaires, de jetons de session, de jetons d’écriture, d’instructions de plateforme bêta, de traces d’erreurs locales, de clés privées ou d’informations d’identification d’API.