agent_authorize

macOS

Objectif

Détermine si le contrat Agent Mesh installé sur cet ordinateur permet d’agir sur un message du Mesh, uniquement d’après l’expéditeur et le type du message, jamais son contenu. Pour une action autorisée, il renvoie un cap_id et les étapes exactes : passez mesh_cap_id avec l’appel d’outil de chaque étape, dans l’ordre ; tout autre appel est refusé tant que l’action est en cours. Pour un message informatif, il indique comment le clore (ack ou reply). Un refus en donne la raison et rien ne doit être fait pour ce message. Ne fonctionne que si le réveil automatique du Mesh est activé sur cet ordinateur.

Entrées requises

• agent_id
• message_id

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "properties": {
    "agent_id": {
      "description": "Your agent_id, the same one you used in agent_checkin.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to act. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    },
    "message_id": {
      "description": "The id of the message from agent_inbox.",
      "type": "integer"
    }
  },
  "required": [
    "agent_id",
    "message_id"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour agent_authorize. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "agent_id": "demo-reviewer",
  "confirm": false,
  "message_id": 101
}