agent_authorize

macOS

Scopo

Decide se il contratto di Agent Mesh installato su questo computer consente di agire su un messaggio della Mesh, in base solo al mittente e al tipo del messaggio, mai al suo contenuto. Per un'azione consentita restituisce un cap_id e i passaggi esatti: passa mesh_cap_id con la chiamata allo strumento di ogni passaggio, in ordine; qualsiasi altra chiamata viene rifiutata mentre l'azione è in corso. Per un messaggio informativo indica come chiuderlo (ack o reply). Un rifiuto ne spiega il motivo e per quel messaggio non si può fare nulla. Funziona solo quando l'attivazione automatica della Mesh (auto-wake) è abilitata su questo computer.

Input obbligatori

• agent_id
• message_id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

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

Esempio documentale

Esempio di documentazione per agent_authorize. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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