agent_send

Agentennetwerk · macOS · Windows

Effect: verzenden. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Stuurt een coördinatiebericht naar een agent op een ANDERE machine van de gebruiker; haal diens handle uit agents_list. Gebruik het om merges tijdens een release stil te leggen ('freeze'), een beschikbare PR te melden ('pr-ready'), werk over te dragen ('handoff') of een release te melden ('release-out'). Zonder to_agent bereikt het alle agents op die machine. Een gerichte to_agent moet ALIVE zijn en uit agents_list komen; verzin hem nooit. Bij een 404 krijg je de agent_ids die WEL leven, zodat je opnieuw kunt adresseren. De ontvanger krijgt het bericht bij de volgende agent_inbox-controle; dit is niet direct en niet afdwingbaar.

Vereiste invoer

to
msg_type

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor agent_send. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows

Doel

Stuurt een coördinatiebericht naar een agent op een ANDERE machine van de gebruiker; haal diens handle uit agents_list. Gebruik het voor een releaseblokkade ('freeze'), een beschikbare PR ('pr-ready'), overdracht ('handoff') of een uitgebrachte release ('release-out'). Zonder to_agent bereikt het alle agents op die machine. De ontvanger krijgt het bij de volgende agent_inbox-controle; dit is niet direct en de andere agent beslist zelf wat ermee gebeurt.

Vereiste invoer

to
msg_type

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — Windows

{
  "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"
}

Documentatievoorbeeld

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