Referencia de Work IQ en SharePoint (versión preliminar)

Importante

Esta es una característica en vista previa.

• Microsoft publica versiones preliminares de las características antes de un lanzamiento oficial para que los clientes puedan tener 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_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/ servers/mcp_SharePointRemoteServer	Work IQ SharePoint	Servidor MCP para operaciones de SharePoint. Use este servidor para administrar sitios, listas, elementos de lista, columnas, bibliotecas de documentos, archivos, carpetas y uso compartido de archivos. Las operaciones de archivo se limitan a los archivos de 5 MB o menos.

Herramientas disponibles

encontrarSitio

Encuentra los sitios de SharePoint a los que puede acceder. Devuelve sitios específicos que coinciden con una consulta de búsqueda o los 20 sitios relevantes principales si no proporciona una consulta.

Parámetros opcionales:

• searchQuery: Consulta de búsqueda (nombre completo o parcial del sitio). Omitir para devolver los 20 sitios accesibles principales.

getSiteByPath

Resuelve un sitio de SharePoint mediante su nombre de host exacto y la ruta de acceso relativa al servidor. Use este método solo cuando tenga la estructura completa de la dirección URL del sitio. Use findSite cuando solo conozca un nombre de sitio.

Parámetros requeridos:

• nombre de host: Nombre de host exacto (por ejemplo, "contoso.sharepoint.com")
• serverRelativePath: Ruta de acceso relativa al servidor (por ejemplo, "sites/Marketing"). La barra diagonal inicial es opcional.

listSubsites

Enumera todos los subsitios (sitios secundarios) de un sitio de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio primario de SharePoint (formato: 'nombre de host,siteCollectionId,webId')

listarBibliotecasDeDocumentosEnSitio

Enumera las bibliotecas de documentos (unidades) en el sitio de SharePoint especificado.

Parámetros opcionales:

• siteId: Id. del sitio de SharePoint (valor predeterminado: "raíz")

obtenerBibliotecaDeDocumentosPredeterminadaEnSitio

Obtiene la biblioteca de documentos predeterminada (drive) de un sitio de SharePoint.

Parámetros opcionales:

• siteId: Id. del sitio de SharePoint (valor predeterminado: "raíz")

getFolderChildren

Enumera los 20 primeros archivos y carpetas (DriveItems) dentro de una carpeta primaria especificada en una biblioteca de documentos (unidad).

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

findFileOrFolder

Busca un archivo o carpeta (DriveItem) accesible para el usuario mediante una consulta de búsqueda. Busca en todos los sitios y bibliotecas de documentos a los que el usuario tiene acceso.

Parámetros requeridos:

• searchQuery: Consulta de búsqueda (nombre de archivo completo o parcial)

getFileOrFolderMetadata

Obtiene los metadatos de un archivo o carpeta (DriveItem) de la biblioteca de documentos (drive) especificada en SharePoint.

Parámetros requeridos:

• fileOrFolderId: Identificador del archivo o carpeta (DriveItem)
• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

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 podrán obtener los metadatos.

Parámetros requeridos:

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

readSmallTextFile

Lee (descarga) un archivo de texto de menos de 5 MB desde una biblioteca de documentos específica (unidad).

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem) para leer o descargar
• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

readSmallBinaryFile

Lee un archivo binario de menos de 5 MB de una biblioteca de documentos concreta (drive). El contenido del archivo se devuelve como una cadena codificada en base64.

Parámetros requeridos:

• fileId: Identificador del archivo (DriveItem) para leer o descargar
• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

createSmallTextFile

Cree o cargue un archivo de texto inferior a 5 MB en una biblioteca de documentos (unidad) específica.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo, incluida la extensión
• contentText: Contenido de texto del archivo
• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

crearArchivoBinarioPequeño

Crea un archivo binario inferior a 5 MB mediante la codificación base64 de su contenido en una biblioteca de documentos (unidad) específica.

Parámetros requeridos:

• nombre de archivo: Nombre del archivo, incluida la extensión
• base64Content: Contenido de archivo binario codificado como una cadena base64.
• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

crearCarpeta

Crea una nueva carpeta (DriveItem) en una biblioteca de documentos (drive) especificada. Si existe una carpeta con el mismo nombre, el sistema agrega un sufijo numérico (por ejemplo, NewFolder (1)).

Parámetros requeridos:

• folderName: Nombre de la carpeta
• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)

Parámetros opcionales:

• parentFolderId: Identificador de la carpeta primaria (valor predeterminado: 'root')

renameFileOrFolder

Cambia el nombre de un archivo o carpeta (DriveItem) dentro de una biblioteca de documentos (unidad) especificada. El nuevo nombre debe cumplir con las convenciones de nomenclatura.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)
• fileOrFolderId: Id. del archivo o carpeta para cambiar el nombre
• newFileOrFolderName: Nuevo nombre

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

eliminarArchivoOCarpeta

Elimina un archivo o carpeta (DriveItem) de una biblioteca de documentos (unidad) especificada.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)
• fileOrFolderId: Identificador del archivo o carpeta que se va a eliminar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

moveFileOrFolder

Mueve un archivo o carpeta (DriveItem) a una carpeta de destino. Admite trasladar documentos entre diferentes bibliotecas de documentos (repositorios) dentro de SharePoint. Esta operación es asincrónica. Use checkOperationStatus para supervisar el progreso.

Parámetros requeridos:

• sourcedoclibid: Identificador de la biblioteca de documentos de origen (disco)
• sourcefileid: Identificador del archivo o carpeta de origen que se va a mover
• destdoclibid: Identificador de la biblioteca de documentos de destino (drive)
• destfolderid: Identificador de la carpeta de destino (debe existir)

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento movido

copyFileOrFolder

Copia un archivo o carpeta (DriveItem) en una carpeta de destino. Admite la copia en diferentes bibliotecas de documentos dentro de SharePoint. Esta operación es asincrónica. Use checkOperationStatus para supervisar el progreso.

Parámetros requeridos:

• sourcedoclibid: Identificador de la biblioteca de documentos de origen (disco)
• sourcefileid: Identificador del archivo o carpeta de origen que se va a copiar
• destdoclibid: Identificador de la biblioteca de documentos de destino (drive)
• destfolderid: Identificador de la carpeta de destino (debe existir)

Parámetros opcionales:

• newfilename: Nuevo nombre para el elemento copiado

checkOperationStatus

Comprueba el estado de una operación asincrónica, como una copia o movimiento, mediante el token de operación devuelto desde la operación original.

Parámetros requeridos:

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

subirArchivoDesdeUrl

Carga un archivo desde una URL de SharePoint o OneDrive a una carpeta de destino en una biblioteca de documentos (drive). El archivo se copia de la dirección URL de origen, por lo que el archivo original no cambia.

Parámetros requeridos:

• sourceUrl: Dirección URL de origen (debe ser una dirección URL válida de SharePoint o OneDrive)
• destinationDocumentLibraryId: Identificador de la biblioteca de documentos de destino. Utilice me para el OneDrive del usuario

Parámetros opcionales:

• destinationFolderId: Identificador de la carpeta de destino (valor predeterminado: root)
• nombre de archivo: Nuevo nombre de archivo; el valor predeterminado es el nombre de archivo original.

compartirArchivoOCarpeta

Envía una invitación de uso compartido para conceder permisos de lectura o escritura sobre un archivo o carpeta (DriveItem) en una biblioteca de documentos (drive) especificada.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)
• fileOrFolderId: Identificador del archivo o carpeta que se va a compartir
• recipientEmails: Matriz de direcciones de correo electrónico de destinatarios
• roles: Matriz de roles: 'lectura', 'escritura' (escritura otorga lectura y escritura)

Parámetros opcionales:

• Mensaje: Mensaje personalizado para el correo electrónico de invitación (valor predeterminado: este es el archivo en el que estamos colaborando).
• sendInvitation: Si se va a enviar una invitación para compartir (valor predeterminado: true)

setSensitivityLabelOnFile

Establezca la etiqueta de confidencialidad de un archivo de la biblioteca de documentos (unidad) especificada.

Parámetros requeridos:

• documentLibraryId: Identificador de la biblioteca de documentos (unidad de almacenamiento)
• fileId: Identificador del archivo (DriveItem)
• sensitivityLabelId: Identificador de la etiqueta de confidencialidad o cadena vacía para quitarla

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")

listLists

Obtiene todas las listas de SharePoint disponibles en un sitio específico. Use para detectar qué listas existen en un sitio.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint (formato: 'hostname,siteCollectionId,webId')

crearLista

Crea una nueva SharePoint list dentro de un sitio.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• displayName: Nombre para mostrar de la nueva lista

Parámetros opcionales:

• columnas: Colección de columnas en forma de pares clave-valor: [{ Key: 'JobTitle', Value: 'text' }]. Tipos válidos: texto, textoMultilínea, número, booleano, fechaHora, opción, búsqueda, personaOGrupo, hipervínculo, moneda, calculado
• plantilla: Tipo de plantilla de lista (valor predeterminado: 'genericList'). Opciones: listaGenérica, bibliotecaDocumentos, eventos, tareas, anuncios, contactos, enlaces, encuesta, seguimientoDeProblemas, foroDeDiscusión

eliminarLista

Elimina una lista de SharePoint de un sitio. Elimina todo el contenedor de listas y todos los elementos que contiene. No se puede deshacer.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista que se va a eliminar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

sendInviteForList

Envía una invitación para compartir para conceder permisos en una lista de SharePoint.

Parámetros requeridos:

• listId: Identificador de la lista de SharePoint que se va a compartir
• recipientEmails: Matriz de direcciones de correo electrónico de destinatarios
• rol: Rol: 'lectura' (solo vista), 'colaborar' (ver, agregar, actualizar, eliminar elementos), 'editar' (edición completa, incluida la estructura de lista)

Parámetros opcionales:

• siteUrl: Dirección URL del sitio de SharePoint que contiene la lista
• sendEmail: Si se debe enviar una notificación por correo electrónico (valor predeterminado: true)

listListItems

Obtiene elementos (filas o registros) de una lista específica de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint

getListItem

Obtiene un elemento (fila/registro) de una lista de SharePoint por su ID.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• itemId: Identificador del elemento de lista específico

crearElementoLista

Crea un nuevo elemento (fila o registro) en un SharePoint list.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• campos: pares clave-valor para valores de campo: [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Normalmente, el campo 'Título' es obligatorio

updateListItem

Actualiza un elemento existente (fila o registro) en una lista de SharePoint. Solo se actualizan los campos especificados; Los campos omitidos conservan sus valores.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• itemId: Identificador del elemento que se va a actualizar
• campos: Pares clave-valor de los campos que se van a actualizar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

eliminarElementoDeLista

Elimina un elemento (fila o registro) de una lista de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• itemId: Identificador del elemento que se va a eliminar

Parámetros opcionales:

• etag: ETag para el control de simultaneidad

listColumns

Obtiene todas las columnas de una lista de SharePoint.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint

crearColumna

Crea una nueva columna en un SharePoint list. Admite muchos tipos de columna, incluyendo texto, número, opción, fechaHora, booleano, usuario, búsqueda, calculado y más.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• name: Nombre de columna interno (identificador de programación)
• columnType: tipo de columna: texto, nota, número, entero, booleano, dateTime, opción, multichoice, moneda, búsqueda, usuario, url, calculado, término, multiterm, ubicación, geolocalización, miniatura, contador, calculado, contentTypeId, archivo, adjunto, guid, outcomeChoice, approvalStatus

Parámetros opcionales:

• columnProperties: Configuración específica del tipo (por ejemplo, { "maxLength": 255 } para texto, { "choices": ["A","B","C"] } para elección)
• descripción: Descripción de la columna
• displayName: Nombre para mostrar que se muestra en la interfaz de usuario (el valor predeterminado es "name")
• Obligatorio: Haga que la columna sea necesaria (valor predeterminado: false)
• oculto: Ocultar columna de vistas (valor predeterminado: false)

actualizarColumna

Actualiza una columna existente en un SharePoint list.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• columnId: Identificador de la columna que se va a actualizar

Parámetros opcionales:

• columnType: Tipo de columna (obligatorio al proporcionar 'columnProperties')
• columnProperties: Propiedades específicas del tipo que se van a actualizar
• descripción: Nueva descripción
• displayName: Nuevo nombre para mostrar
• oculto: Ocultar o mostrar columna
• Obligatorio: Hacer que la columna sea necesaria o opcional

eliminarColumna

Elimina una columna de un SharePoint list. Advertencia: Esta acción quita todos los datos almacenados en esa columna para todos los elementos.

Parámetros requeridos:

• siteId: Id. del sitio de SharePoint
• listId: Identificador de la lista de SharePoint
• columnId: Identificador de la columna que se va a eliminar

Características clave

Administración de sitios

• Buscar sitios por su nombre o explorar sitios accesibles.
• Obtenga el sitio por la ruta exacta de la ruta URL.
• Liste sitios infantiles y subsitios.
• Navegación completa de la jerarquía de sitios.

Administración de bibliotecas de documentos

• Enumere todas las bibliotecas de documentos de un sitio.
• Obtenga la biblioteca de documentos predeterminada.
• Examinar el contenido de la carpeta (hasta 20 elementos)
• Cree y administre estructuras de carpetas.

Operaciones de archivo

• Cree archivos binarios y de texto (≤5 MB).
• Leer archivos binarios y de texto (≤5 MB).
• Elimine, cambie el nombre y mueva archivos y carpetas.
• Copiar archivos y carpetas entre bibliotecas de documentos.
• Cargue archivos desde direcciones URL de SharePoint o OneDrive.
• Busque archivos y carpetas en todos los sitios accesibles.
• Obtiene los metadatos de archivo y carpeta.

Operaciones asincrónicas

• Copie y mueva archivos y carpetas de forma asincrónica entre bibliotecas de documentos.
• Compruebe el estado de las operaciones asincrónicas mediante tokens de operación.

Operaciones de lista

• Crear, leer y eliminar listas.
• Compatibilidad con varias plantillas de lista, como la biblioteca de documentos, los eventos y las tareas genéricas.
• Compartir listas con permisos basados en roles.
• Administre los elementos de lista mediante la creación, lectura, actualización y eliminación de ellos.

Administración de columnas

• Cree columnas con una amplia variedad de tipos, como texto, nota, número, booleano, fecha y hora, elección, búsqueda, usuario, URL, calculado y más.
• Actualice las propiedades y los metadatos de la columna.
• Configure los requisitos y la visibilidad de las columnas.
• Establecer propiedades de columna según el tipo.

Uso compartido y permisos

• Compartir archivos, carpetas y listas con usuarios.
• Use el control de acceso basado en roles con roles de lectura, escritura, contribución y edición.
• Notificaciones por correo electrónico para compartir
• Mensajes personalizados en 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

• Las operaciones de archivo se limitan a los archivos de 5 MB o menos para la carga y descarga.
• Las operaciones de copia y movimiento son asincrónicas. Use checkOperationStatus para supervisar el progreso.
• Las operaciones de copia y movimiento admiten operaciones entre bibliotecas dentro de SharePoint.
• uploadFileFromUrl requiere una dirección URL de origen válida SharePoint o OneDrive.
• eTags proporcionan control de simultaneidad para las actualizaciones y eliminaciones.
• Sufijo numérico automático para nombres de carpeta duplicados
• La eliminación de listas no se puede deshacer.
• La eliminación de columnas quita todos los datos almacenados en esa columna.
• Las operaciones de búsqueda devuelven los 20 resultados principales de forma predeterminada.