Vai al contenuto
Tutti gli strumenti

reply_email

E-mail · macOS

Effetto: invio. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Usalo quando l'utente vuole rispondere a un'e-mail che si trova in Apple Mail del Mac (ID messaggio da list_emails/search_emails). Mostra un'anteprima prima dell'invio. La risposta inviata contiene il tuo testo seguito da una citazione in testo semplice dell'originale ("On <date>, <sender> wrote:" e le righe dell'originale precedute da `> `), nello stesso thread; `html_body` viene convertito in testo semplice. Se l'originale non ha testo leggibile, la risposta viene inviata solo con il tuo testo e la risposta dello strumento lo segnala (`quoted_original: false` e un avviso da riferire). Per lasciare la risposta nelle Bozze SENZA inviarla, passa `save_as_draft: true`: la bozza è nel thread giusto con i destinatari di Rispondi/Rispondi a tutti e contiene lo stesso contenuto (non la citazione formattata di Mail), e `send` non viene mai chiamato. In entrambi i casi, se Mail non conserva il testo o la citazione, la chiamata fallisce e nulla viene inviato né salvato. `create_draft` con `reply_to_message_id` lascia lo stesso tipo di bozza. Per un ID messaggio Microsoft 365 da m365_list_emails, usa m365_reply_email. Passa `account` (dai risultati di list_emails/search_emails) per saltare la scansione degli altri account ed evitare timeout sui Mac con più account.

Input obbligatori

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.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "account": {
      "description": "Account (from the listing) the message is in — pass it to skip scanning other accounts and avoid multi-account timeouts.",
      "type": "string"
    },
    "body": {
      "description": "Plain-text reply body.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Preview first: the first call previews the reply; call again with confirm=true to actually send it — or to save it when save_as_draft is set.",
      "type": "boolean"
    },
    "html_body": {
      "description": "HTML reply body. Takes precedence over `body` when both are given. It is converted to plain text: a reply is sent, or saved, as text with a plain-text quote of the original.",
      "type": "string"
    },
    "message_id": {
      "description": "Id of the message to reply to (from list_emails/search_emails).",
      "type": "string"
    },
    "reply_all": {
      "default": "false",
      "description": "Reply to all original recipients instead of just the sender.",
      "type": "boolean"
    },
    "save_as_draft": {
      "default": "false",
      "description": "Save the reply in Drafts instead of sending it: your text followed by a plain-text quote of the original, in the right thread, with the Reply/Reply-All recipients. Nothing is sent on this path.",
      "type": "boolean"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per reply_email. 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.

{
  "body": "Can we review the launch checklist on Tuesday?",
  "confirm": false,
  "message_id": "demo-message-001"
}