Referencia de correo (vista previa)

Note

Las características de este artículo son impulsadas por el arnés estándar, que utiliza las opciones de facturación descritas en Licencias para agentes alimentados por el arnés estándar. Aprende cómo acceder a las funciones estándar en Access agentes estándar y flujos de agentes.

Importante

Se trata de una característica en versión preliminar.

• Microsoft publica características en versión preliminar antes de su lanzamiento oficial para que los clientes puedan obtener acceso anticipado y enviar comentarios.
• Las características en versión preliminar tienen funcionalidad restringida y no están pensadas para su uso en producción.
• Microsoft podría cambiar los nombres y parámetros de la herramienta MCP en versión preliminar. Evite las dependencias codificadas de forma rígida. Microsoft mantiene la compatibilidad con escenarios.
• Las características en versión preliminar se rigen por los términos de uso adicionales de Microsoft.

Overview

Id. de servidor	Dirección URL a nivel de arrendatario	Nombre para mostrar	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Herramientas para operaciones de correo de Microsoft Graph, incluyendo crear, enviar, responder y gestionar mensajes de correo electrónico.

Herramientas disponibles

mcp_MailTools_graph_mail_createMessage

Crear un borrador de correo electrónico. Soporta HTML configurando body.body.contentType = "HTML".

Parámetros requeridos:

• subject: asunto del mensaje
• toRecipients: matriz de destinatarios con direcciones de correo electrónico
• body: cuerpo del mensaje con contentType (Texto/HTML) y contenido

Parámetros opcionales:

• preferHtml: establézcalo en true para el contenido HTML
• headers: encabezados adicionales opcionales

mcp_MailTools_graph_mail_deleteMessage

Elimina un mensaje del buzón del usuario que ha iniciado sesión.

Parámetros requeridos:

• id: Id. de mensaje

Parámetros opcionales:

• If-Match: Opcional para controlar la concurrencia

mcp_MailTools_graph_mail_getMessage

Obtiene un mensaje por identificador del buzón del usuario que ha iniciado sesión. Utiliza preferHtml para solicitar el cuerpo HTML.

Parámetros requeridos:

• id: Id. de mensaje

Parámetros opcionales:

• select: Cláusula select de OData
• expand: cláusula "expand" de OData
• preferHtml: formato de cuerpo HTML de solicitud
• encabezados: encabezados HTTP opcionales

mcp_MailTools_graph_mail_listSent

Haz una lista de mensajes en los elementos enviados.

Parámetros opcionales:

• filter: filtro OData
• search: consulta de búsqueda
• orderby: Expresión de ordenación
• top: Número de elementos que se deben devolver
• select: Campos que devolver

mcp_MailTools_graph_mail_reply

Envía una respuesta a un mensaje existente. Admite HTML a través de preferHtml o headers.

Parámetros requeridos:

• id: Id. de mensaje al que responder

Parámetros opcionales:

• comment: Texto de respuesta
• message: invalidaciones de mensajes opcionales
• preferHtml: Habilitar el formato HTML
• encabezados: encabezados HTTP opcionales

mcp_MailTools_graph_mail_replyAll

Envía una respuesta a todos a un mensaje existente. Admite HTML a través de preferHtml o headers.

Parámetros requeridos:

• id: ID de mensaje para responder a todos

Parámetros opcionales:

• comment: Texto de respuesta
• message: invalidaciones de mensajes opcionales
• preferHtml: Habilitar el formato HTML
• encabezados: encabezados HTTP opcionales

mcp_MailTools_graph_mail_searchMessages

Buscar mensajes de Outlook mediante la API de búsqueda de Microsoft Graph con consultas en estilo de lenguaje de consulta de palabras clave (KQL).

Parámetros requeridos:

• Solicitudes: Array de solicitudes de búsqueda con parámetros de consulta, from, y tamaño.

Admite la búsqueda de contenido de mensajes, asunto, cuerpo y datos adjuntos

mcp_MailTools_graph_mail_sendDraft

Envíe un mensaje de borrador existente por identificador.

Parámetros requeridos:

• id: Borrador del identificador de mensaje que se va a enviar

mcp_MailTools_graph_mail_sendMail

Enviar un correo electrónico como usuario que ha iniciado sesión.

Parámetros requeridos:

• Mensaje: Objeto mensaje con asunto, toRecipients, y cuerpo
• subject: Asunto del correo electrónico
• toRecipients: destinatarios principales
• body: Cuerpo del correo electrónico con contentType (Texto/HTML) y contenido

Parámetros opcionales:

• ccRecipients: destinatarios de copia de carbono
• bccRecipients: destinatarios de copia oculta
• saveToSentItems: Guardar en los elementos enviados (valor predeterminado: verdadero)
• preferHtml: Forzar representación HTML
• headers: encabezados HTTP adicionales opcionales

10. mcp_MailTools_graph_mail_updateMessage

Actualiza las propiedades mutables de un mensaje, como el asunto, el cuerpo y las categorías.

Parámetros requeridos:

• id: Id. de mensaje

Parámetros opcionales:

• subject: Nuevo asunto
• body: nuevo cuerpo del mensaje
• categories: categorías de mensajes
• importance: Baja, Normal o Alta
• If-Match:ETag para el control de concurrencia

Características clave

Composición del correo electrónico

• Crear borradores y enviar correos electrónicos
• Soporte para HTML y texto plano
• Destinatarios Para, CC y BCC
• Opciones de formato enriquecido

Administración de correo electrónico

• Obtener, actualizar y eliminar mensajes.
• La funcionalidad de responder y responder a todos.
• Gestión de borradores.
• Configuración de categoría e importancia.

Búsqueda y filtrado

• Búsqueda de mensajes con sintaxis KQL.
• Compatibilidad con consultas de OData.
• Buscar en el asunto, el cuerpo del mensaje y los archivos adjuntos.
• Paginación y filtrado.

Sentitems

• Enumerar mensajes enviados.
• Guardado opcional en Elementos enviados.
• Filtre y busque elementos enviados.

Notas

• Todas las operaciones usan Microsoft Graph Mail API.
• El contenido HTML requiere contentType = "HTML" en el cuerpo.
• preferHtml El encabezado solicita el formato HTML para el cuerpo.
• La búsqueda usa Microsoft Graph Search API con consultas KQL.
• Los borradores de mensajes se pueden crear, actualizar y enviar por separado.
• ETag soporte para el control de concurrencia en las actualizaciones.