Saltar al contenido
Todas las herramientas

agent_authorize

Malla de agentes · macOS

Efecto: escritura. 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

Decide si el contrato de Agent Mesh instalado en este equipo permite actuar sobre un mensaje de la malla, únicamente a partir del remitente y el tipo del mensaje, nunca de su contenido. Para una acción permitida devuelve un cap_id y los pasos exactos: pasa mesh_cap_id en la llamada a la herramienta de cada paso, en orden; cualquier otra llamada se rechaza mientras la acción está en curso. Para un mensaje informativo indica cómo cerrarlo (ack o reply). Un rechazo dice por qué y no debe hacerse nada con ese mensaje. Solo funciona cuando el despertar automático de la malla está activado en este equipo.

Entradas obligatorias

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 declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

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

Ejemplo documental

Ejemplo de documentación para agent_authorize. 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.

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