agent_send

Malla de agentes · macOS · Windows

Efecto: envío. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Envía un mensaje de coordinación a un agente en OTRA de las máquinas del usuario (obtenga su identificador de agents_list). Úselo para retener fusiones durante un lanzamiento ("congelación"), anunciar que un PR está activo ("pr-ready"), entregar el trabajo ("handoff") o decir que se envió un lanzamiento ("liberación"). Sin to_agent, llega a todos los agentes de esa máquina, que es lo que desea congelar. Un `to_agent` DIRIGIDO debe corresponder a un agente ACTIVO; tómelo de agents_list, nunca lo invente: si no está vivo, obtendrá un 404 que enumera los `agent_ids` que están activos en esa máquina, por lo que puede volver a dirigirse a uno de esos en lugar de que el mensaje se pierda silenciosamente. El destinatario lo recibe en su siguiente encuesta agent_inbox; esto no es instantáneo y no es una solicitud que pueda forzar: el otro agente decide qué hacer.

Entradas obligatorias

to
msg_type

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para agent_send. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows