Referencia a OneDrive (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	Descripción
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Herramientas para operaciones de OneDrive. Use este servidor para administrar archivos y carpetas en el OneDrive personal del usuario. Todas las operaciones de archivo limitadas a ≤5MB.

Herramientas disponibles

getOnedrive

Obtiene información sobre la OneDrive del usuario, incluidos los metadatos de unidad, la cuota y la información del propietario.

No se requiere ningún parámetro.

getFolderChildrenInMyOnedrive

Enumera los 20 primeros archivos y carpetas (DriveItems) incluidos en una carpeta primaria especificada en el OneDrive del usuario.

Parámetros opcionales:

• parentFolderId: Id. de la carpeta primaria cuyos archivos y carpetas desea enumerar (valor predeterminado: "raíz")

buscarArchivoOCarpetaEnMiOneDrive

Busca un archivo o carpeta (DriveItem) en la consulta de búsqueda de OneDrive del usuario. Este método es más eficaz que buscar todos los archivos accesibles si sabe que el elemento está en la OneDrive del usuario.

Parámetros requeridos:

• searchQuery: Consulta de búsqueda; puede ser el nombre de archivo completo o parcial.

getFileOrFolderMetadataInMyOnedrive

Obtiene los metadatos de un archivo o carpeta (DriveItem) del OneDrive del usuario.

Parámetros requeridos:

• fileOrFolderId: Id. del archivo o carpeta del OneDrive del usuario

getFileOrFolderMetadataByUrl

Obtiene los metadatos de un archivo o carpeta (DriveItem) de una dirección URL de uso compartido. Solo los usuarios con permisos explícitos existentes para acceder al archivo pueden obtener los metadatos.

Parámetros requeridos:

• fileOrFolderUrl: Dirección URL del archivo o carpeta. La dirección URL no se utiliza para compartirla con el usuario; este ya debe tener acceso explícito.

leerArchivoDeTextoPequeñoDeMiOnedrive

Lee (descarga) un archivo de texto del OneDrive del usuario.

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem) para leer o descargar

crearArchivoDeTextoPequeñoEnMiOneDrive

Crea o carga un archivo de texto inferior a 5 MB en el OneDrive del usuario.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo que se va a crear
• TextoContenido: Contenido de texto del archivo.

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

crearCarpetaEnMiOnedrive

Crea una nueva carpeta (DriveItem) en el OneDrive del usuario como elemento secundario de la carpeta primaria especificada. Si ya existe una carpeta con el mismo nombre, el método agrega un sufijo numérico (por ejemplo, NewFolder (1)).

Parámetros requeridos:

• folderName: Nombre de la carpeta que se va a crear

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

renameFileOrFolderInMyOnedrive

Cambia el nombre de un archivo o carpeta (DriveItem) en el OneDrive del usuario. El nuevo nombre debe cumplir con las convenciones de nomenclatura.

Parámetros requeridos:

• fileOrFolderId: Id. del archivo o carpeta para cambiar el nombre
• newFileOrFolderName: Nuevo nombre para el archivo o carpeta

Parámetros opcionales:

• etag: Valor de ETag para el control de simultaneidad. La operación solo tiene éxito si el ETag actual de DriveItem coincide con

borrarArchivoOCarpetaEnMiOnedrive

Elimina un archivo o carpeta (DriveItem) del OneDrive del usuario.

Parámetros requeridos:

• fileOrFolderId: Identificador del archivo o carpeta que se va a eliminar

Parámetros opcionales:

• etag: Valor de ETag para el control de simultaneidad

compartirArchivoOCarpetaEnMiOnedrive

Envía una invitación para compartir para conceder permisos de lectura o escritura en un archivo o carpeta (DriveItem) en el OneDrive del usuario.

Parámetros requeridos:

• fileOrFolderId: Identificador del archivo o carpeta que se va a compartir
• recipientEmails: Matriz de direcciones de correo electrónico de destinatarios que se van a invitar
• roles: Matriz de roles que se van a asignar. Valores aceptados: "read", "write" (write concede lectura y escritura)

Parámetros opcionales:

• Mensaje: Mensaje personalizado que se va a incluir en el correo electrónico de invitación. Valor predeterminado: "Este es el archivo en el que estamos colaborando".
• sendInvitation: Indica si se va a enviar una invitación para compartir. Valor predeterminado: true.

establecerEtiquetaDeSensibilidadEnArchivoEnMiOnedrive

Establece la etiqueta de confidencialidad de un archivo en el OneDrive del usuario.

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem)
• sensitivityLabelId: Identificador de la etiqueta de confidencialidad que se va a asignar o cadena vacía que se va a quitar

Parámetros opcionales:

• assignmentMethod: Método de asignación: "standard", "privileged", "auto" o "unknownFutureValue" (valor predeterminado: "privileged")
• justificationText: Texto de justificación para fines de auditoría; obligatorio al degradar o quitar una etiqueta (valor predeterminado: "Cambiado por MCPServer")

crearArchivoBinarioPequeñoEnMiOnedrive

Crea un archivo binario de tamaño inferior a 5 MB mediante la codificación base64 de su contenido en el OneDrive del usuario.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo que se va a crear, incluida la extensión de archivo
• base64Content: El contenido del archivo binario codificado como una cadena base64

Parámetros opcionales:

• parentFolderId: ID de la carpeta padre (por defecto: 'root').

leerArchivoBinarioPequeñoDeMiOnedrive

Lee un archivo binario inferior a 5 MB del OneDrive del usuario. Devuelve el contenido del archivo como una cadena codificada en base64.

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem) para leer o descargar

copiarArchivoOCarpetaEnMiOnedrive

Copia un archivo o carpeta (DriveItem) en una carpeta de destino dentro del OneDrive del usuario. Esta operación es asincrónica. Use checkOperationStatusInMyOnedrive para supervisar el progreso.

Parámetros requeridos:

• sourcefileid: Identificador del archivo o carpeta de origen (DriveItem) que se va a copiar
• destfolderid: id. de la carpeta de destino (debe existir en el OneDrive del usuario).

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento copiado (el valor predeterminado es el nombre original)

moveFileOrFolderInMyOnedrive

Mueve un archivo o carpeta (DriveItem) a una carpeta de destino dentro del OneDrive del usuario. Esta operación es asincrónica. Use checkOperationStatusInMyOnedrive para supervisar el progreso.

Parámetros requeridos:

• sourcefileid: Identificador del archivo o carpeta de origen (DriveItem) que se va a mover
• destfolderid: id. de la carpeta de destino (debe existir en el OneDrive del usuario).

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento movido (el valor predeterminado es el nombre original)

checkOperationStatusInMyOnedrive

Comprueba el estado de una operación asincrónica, como copiar o mover, mediante el token de operación devuelto desde la operación original. Devuelve información de progreso si aún está en curso, detalles del error si se produce un error o los metadatos finales de archivo o carpeta si se completan correctamente.

Parámetros requeridos:

• operationToken: El token de operación devuelto desde una operación asincrónica como copyFileOrFolderInMyOnedrive o moveFileOrFolderInMyOnedrive

Características clave

administración de OneDrive

• Obtiene información de OneDrive, como la cuota y el propietario.
• Acceso a OneDrive personal del usuario
• Todas las operaciones tienen como destino oneDrive autenticado del usuario

Búsqueda y detección de archivos

• Buscar archivos y carpetas por nombre en OneDrive del usuario
• Obtención de metadatos de archivo o carpeta por identificador o dirección URL de uso compartido
• Explora el contenido de las carpetas (hasta 20 elementos).

Operaciones de archivo

• Crear archivos binarios y de texto (≤5 MB)
• Leer archivos binarios y de texto (≤5 MB)
• Eliminación de archivos con control de simultaneidad
• Cambiar el nombre de los archivos con protección eTag
• Copiar y mover archivos y carpetas de forma asincrónica

Administración de carteras

• Creación de carpetas con rutas de acceso primarias opcionales
• Sufijo numérico automático para nombres duplicados de carpetas.
• Enumerar el contenido de la carpeta (hasta 20 elementos)
• Obtener metadatos de carpeta
• Eliminar carpetas con control de concurrencia
• Cambiar el nombre de las carpetas con protección eTag

Uso compartido y permisos

• Uso compartido de archivos y carpetas con usuarios
• Control de acceso basado en rol (lectura, escritura)
• Notificaciones por correo electrónico para compartir.
• Mensajes personalizados en las invitaciones.

Seguridad y cumplimiento normativo

• Aplicar y eliminar etiquetas de confidencialidad.
• Use varios métodos de asignación, incluidos estándar, con privilegios y automático.
• Compatibilidad con la justificación de auditoría.
• Use el control de simultaneidad con eTags.

Notas

• Todas las operaciones tienen como destino el OneDrive personal del usuario autenticado.
• Las operaciones de archivo se limitan a los archivos de 5 MB o menos para la carga y descarga.
• Las operaciones de eliminación y cambio de nombre admiten eTags para el control de concurrencia.
• El uso compartido requiere direcciones de correo electrónico válidas y permisos adecuados.
• Las etiquetas de confidencialidad requieren una configuración y licencias adecuadas.
• La lista de carpetas devuelve un máximo de 20 elementos de forma predeterminada.