m365_search_emails

Microsoft 365 · macOS · Windows

Efeito: leitura. 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 quando o usuário quiser encontrar e-mails na sua caixa de correio Microsoft 365 / Outlook através da nuvem — requer uma conta M365 conectada. Por padrão pesquisa remetente, assunto E corpo (o comportamento predefinido do $search do próprio Microsoft Graph). Passe scope="metadata" para pesquisar apenas remetente/assunto (mais rápido, sem varrer o corpo), ou scope="body" para pesquisar apenas o corpo da mensagem. Passe folder para pesquisar uma pasta (um nome conhecido, ou um id, nome ou caminho de m365_list_email_folders). Para contas adicionadas ao Mail.app do Mac, use search_emails.

Entradas obrigatórias

query

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 não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "folder": {
      "description": "Search only this folder: a well-known name, or an id, name or path from m365_list_email_folders. Leave it out to search the whole mailbox.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', 'subject:invoice'",
      "type": "string"
    },
    "scope": {
      "description": "\"all\" (default — sender+subject+body, today's behavior), \"metadata\" (sender+subject only), or \"body\" (body only).",
      "enum": [
        "metadata",
        "body",
        "all"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para m365_search_emails. 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.

{
  "query": "launch checklist"
}

Windows