Alle Werkzeuge

agent_send

Agentennetz · macOS · Windows

Wirkung: Senden. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Sendet eine Koordinationsnachricht an einen Agenten auf ANOTHER der Computer des Benutzers (erhalten Sie seinen Handle von agents_list). Verwenden Sie es, um Zusammenführungen während einer Veröffentlichung zu halten („Freeze“), anzukündigen, dass eine PR läuft („PR-Ready“), Arbeit zu übergeben („Handoff“) oder eine veröffentlichte Veröffentlichung anzuzeigen („Release-Out“). Ohne to_agent erreicht es jeden Agenten auf dieser Maschine, was Sie für ein Einfrieren wünschen. Ein DIRECTED to_agent muss ein ALIVE sein – nehmen Sie es von agents_list, erfinden Sie es niemals: Wenn es nicht aktiv ist, erhalten Sie eine 404-Auflistung des agent_ids, das ARE auf diesem Computer aktiv ist, so dass Sie eine neue Adresse an eines davon senden können, anstatt dass die Nachricht stillschweigend verloren geht. Der Empfänger erhält es bei seiner nächsten agent_inbox-Abfrage – dies geschieht nicht sofort und es handelt sich nicht um eine Anfrage, die Sie erzwingen können: Der andere Agent entscheidet, was zu tun ist.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für agent_send. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Sendet eine Koordinationsnachricht an einen Agenten auf ANOTHER der Computer des Benutzers (erhalten Sie sein Handle von agents_list). Verwenden Sie es, um Zusammenführungen während einer Veröffentlichung zu halten („Freeze“), anzukündigen, dass eine PR läuft („PR-Ready“), Arbeit zu übergeben („Handoff“) oder eine veröffentlichte Veröffentlichung anzuzeigen („Release-Out“). Ohne to_agent erreicht es jeden Agenten auf diesem Computer, was Sie für ein Einfrieren wünschen. Der Empfänger erhält es bei seiner nächsten agent_inbox-Abfrage – dies geschieht nicht sofort und es handelt sich nicht um eine Anfrage, die Sie erzwingen können: Der andere Agent entscheidet, was zu tun ist.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für agent_send. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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