agent_send

Maillage d’agents · macOS · Windows

Effet: envoi. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Envoie un message de coordination à un agent sur ANOTHER des machines de l'utilisateur (obtient son identifiant depuis agents_list). Utilisez-le pour suspendre les fusions pendant une version (« geler »), annoncer qu'un PR est terminé (« pr-ready »), confier le travail (« handoff ») ou annoncer qu'une version est expédiée (« release-out »). Sans to_agent, il atteint tous les agents de cette machine, ce qui correspond à ce que vous souhaitez en cas de gel. Un DIRECTED to_agent doit être un ALIVE — prenez-le de agents_list, ne l'inventez jamais : s'il n'est pas vivant, vous obtenez un 404 répertoriant le agent_ids que ARE est vivant sur cette machine, vous pouvez donc vous réadresser à l'un d'entre eux au lieu que le message soit perdu silencieusement. Le destinataire l'obtient lors de son prochain sondage agent_inbox — ce n'est pas instantané et ce n'est pas une demande que vous pouvez forcer : l'autre agent décide quoi faire.

Entrées requises

to
msg_type

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 ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

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.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "from_agent": {
      "description": "Your own agent_id, so the recipient knows who is asking",
      "type": "string"
    },
    "msg_type": {
      "description": "One of: ping, pr-ready, freeze, freeze-clear, release-out, handoff, note",
      "type": "string"
    },
    "payload": {
      "description": "The content: reason, PR number, branch… Keep it small (max 16KB).",
      "type": "object"
    },
    "to": {
      "description": "Handle of the target machine, from agents_list",
      "type": "string"
    },
    "to_agent": {
      "description": "Optional: a single agent_id on that machine (it must have checked in). Omit to reach all of them.",
      "type": "string"
    }
  },
  "required": [
    "to",
    "msg_type"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour agent_send. 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.

{
  "msg_type": "note",
  "payload": {
    "message": "The documentation review is ready."
  },
  "to": "demo-workstation"
}

Windows