Todas as ferramentas

send_email

E-mail · macOS

Efeito: envio. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Use isto quando o usuário quiser enviar um e-mail from para uma conta configurada no Apple Mail do Mac. Compõe e envia via Mail.app; suporta texto simples ou corpo HTML. Para enviar from uma conta do Microsoft 365 NOT adicionada ao Mail.app, use m365_send_email. Passe `from` para enviar from uma conta Mail.app configurada específica em vez do remetente padrão. Passe `attachments` como uma lista separada por vírgulas de caminhos absolutos de arquivos para anexar arquivos.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglêsmacOS
{
  "properties": {
    "attachments": {
      "description": "Files to attach, as comma-separated absolute paths (e.g. a PDF).",
      "type": "string"
    },
    "bcc": {
      "description": "BCC address(es), comma-separated.",
      "type": "string"
    },
    "body": {
      "description": "Plain-text body. Use this OR html_body; if both are given, html_body wins.",
      "type": "string"
    },
    "cc": {
      "description": "CC address(es), comma-separated.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Safety gate: the call only PREVIEWS (nothing is sent) unless confirm:true. Set true to actually send.",
      "type": "boolean"
    },
    "from": {
      "description": "Sender address — on a multi-account Mac, selects which configured Mail.app account sends. Omit to use Mail's default account.",
      "type": "string"
    },
    "html_body": {
      "description": "HTML body. Takes precedence over `body` when both are set.",
      "type": "string"
    },
    "subject": {
      "description": "Subject line.",
      "type": "string"
    },
    "to": {
      "description": "Recipient address(es), comma-separated for multiple.",
      "type": "string"
    }
  },
  "required": [
    "to",
    "subject"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para send_email. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "body": "Can we review the launch checklist on Tuesday?",
  "confirm": false,
  "subject": "Planning meeting",
  "to": "[email protected]"
}