Referência do e-mail (pré-visualização)

Note

Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.

Important

Este é um recurso em versão preliminar.

• Microsoft libera recursos de visualização antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer comentários.
• Os recursos de visualização têm funcionalidade restrita e não são destinados ao uso de produção.
• A Microsoft pode alterar os nomes e os parâmetros das ferramentas MCP em versão prévia. Evite dependências codificadas. A Microsoft mantém suporte a cenários.
• Os recursos de visualização estão sujeitos a Microsoft termos de uso complementares.

Visão geral

ID de servidor	URL no nível do locatário	Nome de exibição	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Ferramentas para operações de correspondência do Microsoft Graph, incluindo criação, envio, resposta e gerenciamento de mensagens de e-mail.

Ferramentas disponíveis

mcp_MailTools_graph_mail_createMessage

Crie um rascunho de e-mail. Suporta HTML configurando body.body.contentType = "HTML".

Parâmetros requeridos:

• assunto: Assunto da mensagem
• toRecipients: Array de destinatários com endereços de e-mail
• corpo: Corpo da mensagem com contentType (Texto/HTML) e conteúdo

Parâmetros opcionais:

• preferHtml: Definido como true para conteúdo HTML
• cabeçalhos: Cabeçalhos adicionais opcionais

mcp_MailTools_graph_mail_deleteMessage

Exclui uma mensagem da caixa de correio do usuário conectado.

Parâmetros requeridos:

• id: ID da mensagem

Parâmetros opcionais:

• If-Match: Opcional ETag para controle de concorrência

mcp_MailTools_graph_mail_getMessage

Recupera uma mensagem pelo ID da caixa de correio do usuário conectado. Use preferHtml para solicitar o corpo do HTML.

Parâmetros requeridos:

• id: ID da mensagem

Parâmetros opcionais:

• select: cláusula de seleção de OData
• expandir: cláusula de expansão OData
• preferHtml: Solicitar formato de corpo em HTML
• cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_lista_enviados

Liste mensagens nos itens enviados.

Parâmetros opcionais:

• filtro: filtro OData
• Busca: Consulta de busca
• orderby: Ordenar expressão
• topo: Número de itens a serem devolvidos
• Selecione os campos a serem retornados.

mcp_MailTools_graph_mail_reply

Envie uma resposta a uma mensagem existente. Suporta HTML via preferHtml ou headers.

Parâmetros requeridos:

• id: ID da mensagem para responder

Parâmetros opcionais:

• comentário: Texto de resposta
• mensagem: Sobrescrições opcionais de mensagem
• preferHtml: Habilitar a formatação HTML
• cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_replyAll

Envie uma resposta geral para uma mensagem existente. Suporta HTML via preferHtml ou headers.

Parâmetros requeridos:

• id: ID da mensagem para responder a todos

Parâmetros opcionais:

• comentário: Texto de resposta
• mensagem: Sobrescrições opcionais de mensagem
• preferHtml: Habilitar a formatação HTML
• cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_searchMessages

Pesquise mensagens do Outlook usando a API de Pesquisa do Microsoft Graph com consultas no estilo KQL (linguagem de consulta de palavra-chave).

Parâmetros requeridos:

• Pedidos: Array de solicitações de busca com entityTypesparâmetros de , consulta, from, tamanho

Suporta busca no conteúdo da mensagem, assunto, corpo e anexos

mcp_MailTools_graph_mail_sendDraft

Envie uma mensagem de rascunho existente por ID.

Parâmetros requeridos:

• id: Rascunho do ID da mensagem para enviar

mcp_MailTools_graph_mail_sendMail

Envie um email como o usuário conectado.

Parâmetros requeridos:

• Mensagem: Objeto mensagem com assunto, toRecipients, e corpo
• assunto: Assunto do e-mail
• para destinatários: Principais destinatários
• corpo: Corpo do e-mail com tipo de conteúdo (Texto/HTML) e conteúdo

Parâmetros opcionais:

• ccDestinatários: Destinatários de cópia conforme
• bccRecipientes: Recipientes cegos com cópias carbono
• saveToSentItems: Salvar em itens enviados (padrão: true)
• preferHtml: Forçar a renderização HTML
• cabeçalhos: Cabeçalhos HTTP adicionais opcionais

10. mcp_MailTools_graph_mail_atualizarMensagem

Atualiza as propriedades mutáveis de uma mensagem, como o assunto, o corpo e as categorias.

Parâmetros requeridos:

• id: ID da mensagem

Parâmetros opcionais:

• assunto: Novo sujeito
• corpo: Corpo da nova mensagem
• categorias: Categorias de mensagens
• importância: Baixo, Normal ou Alto
• If-Match:ETag para controle de concorrência

Principais recursos

Composição do e-mail

• Criar rascunhos e enviar emails
• Suporte a HTML e texto simples
• Destinatários Para, Cc e Cco
• Opções Avançadas de Formatação

Gerenciamento de e-mails

• Obter, atualizar e excluir mensagens.
• A funcionalidade de responder e de responder a todos.
• Gerenciamento de rascunho.
• Configurações de categoria e importância.

Pesquisa e filtragem

• Pesquisa de mensagens no estilo KQL.
• Suporte à consulta OData.
• Pesquise entre assunto, corpo e anexos.
• Paginação e filtragem.

Itens de envio

• Listar mensagens enviadas.
• Salvamento opcional em itens enviados.
• Filtrar e pesquisar itens enviados.

Observações

• Todas as operações usam a API Mail do Microsoft Graph.
• O conteúdo HTML requer contentType = "HTML" no corpo.
• preferHtml o cabeçalho solicita o formato do corpo HTML.
• A pesquisa usa a API de Pesquisa do Microsoft Graph com consultas KQL.
• As mensagens de rascunho podem ser criadas, atualizadas e enviadas separadamente.
• ETag suporte para controle de concorrência nas atualizações.