Compatibilité des agents

Règles du validateur

Échecs et avertissements du validateur de compatibilité des agents pour le repli GET-Action, l'idempotence, les secrets de requête, la découverte JavaScript uniquement, les replis POST/live GET/MCP/auth/tool, l'examen humain et le comportement sans opération.

  • Dossier UAIX-DOC-2754
  • Chemin /fr-fr/spec/validator-rules/
  • 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-2754
Surface
Compatibilité des agents
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez cette page dans le cadre du dossier public Compatibilité des agents actuel, puis suivez ses pages de normes liées pour l'étape suivante.

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.

La validation de compatibilité des agents vérifie d’abord la fonctionnalité annoncée la plus basse.Les interfaces riches ne réussissent que lorsque la découverte de capacités inférieures est honnête et limitée.

Échecs requis

  • get_action_fallback_required: la compatibilité L0/L1 échoue lorsqu’une action principale inscriptible est POST uniquement et qu’il n’existe aucun repli GET documenté ou aucune opération URL.
  • get_action_idempotency_required: GET-Action échoue lorsqu’un exemple capable d’écrire ne dispose pas de idempotency_key ou nonce.
  • get_action_query_secret: GET-L’action échoue lorsque des exemples placent des secrets, des jetons, des mots de passe, des identifiants de compte, des identifiants médicaux, des données de paiement, des messages privés ou des identifiants réglementés dans URLs.
  • get_action_js_only_discovery: GET-L’action échoue lorsque la découverte est masquée derrière l’interface utilisateur JavaScript uniquement.
  • llms_minimal_instruction_required: la découverte L0/L1 échoue lorsque llms.txt pointe uniquement vers des OpenAPI complexes ou des spécifications d’outils et omet les instructions minimales directes.
  • retry_loop_no_op_violation: la gestion sans opération échoue lorsque les agents non pris en charge sont invités à continuer de réessayer ou de deviner.

Avertissements requis

  • post_equivalent_recommended: avertir lorsqu’une action GET n’a pas d’équivalent POST ou OpenAPI pour les clients capables.
  • get_action_security_order_warning: avertir lorsque des exemples apparaissent avant les limites de consentement et de sécurité.
  • side_effecting_get_discovery_warning: avertir lorsque des liens GET à effets secondaires sont présentés comme des raccourcis de découverte généraux.
  • browser_form_fallback_required: avertir lorsque les instructions POST ciblées sur le navigateur ne disposent pas d’un formulaire visible ou d’une solution de secours ouverte par le navigateur.
  • restore_readback_required: avertir lorsque les instructions de création/mise à jour ne disposent pas d’une restauration ou d’une relecture URL et force la supposition du point de terminaison.
  • dashboard_default_path_warning: avertir lorsque les chemins du tableau de bord ou du modèle personnalisé sont présentés par défaut alors que les chemins du profil ou du package générés existent.
  • highest_lowest_path_required: avertir lorsqu’un itinéraire omet highest_supported_path ou lowest_safe_fallback.
  • post_blocked_fallback_required: avertir lorsqu’un chemin POST omet le comportement de secours pour les agents qui ne peuvent pas exécuter JSON POST arbitraire.
  • live_get_blocked_fallback_required: avertir lorsque le guidage dynamique GET cible les agents au niveau du chatbot sans déclarer HTTP GET en direct et une solution de secours pour les récupérateurs indexés uniquement.
  • mcp_unavailable_fallback_required: avertir lorsque la prise en charge de MCP est référencée sans une solution de secours MCP indisponible.
  • auth_unavailable_fallback_required: avertir lorsqu’une mutation authentifiée est référencée sans solution de secours non authentifiée ni examen public URL.
  • tool_unavailable_fallback_required: avertir lorsque l’utilisation de l’outil est référencée sans outil de repli indisponible.
  • human_review_url_required: avertir lorsqu’une action non prise en charge peut bloquer sans examen humain public URL.
  • no_op_behavior_required: avertir lorsqu’un comportement de capacité non pris en charge ne demande pas de s’arrêter en toute sécurité.

Appareils d’essai

La version publie les enregistrements de luminaires positifs et négatifs JSON pour ces familles de règles sous l’arborescence d’exemples UAI-1 et expose le catalogue de règles viaagent-compatibility.json.