Sites
Sites te ayuda a localizar los sitios de SharePoint a los que tienes acceso: los lista o los busca por nombre, consulta los datos de un sitio concreto o del sitio principal de tu organización y devuelve las bibliotecas de documentos de un sitio.
Normalmente se usa como paso previo de Documents o Lists: te da los identificadores del sitio y de sus bibliotecas que esos componentes necesitan cuando los escribes a mano.
Cuándo usarlo
- Un agente de IA tiene que averiguar en qué sitio de SharePoint está la documentación de un departamento.
- Quieres obtener los identificadores de un sitio y de sus bibliotecas para usarlos en otros componentes.
- Necesitas una relación de los sitios a los que tiene acceso una cuenta.
- Quieres saber cuánto espacio ocupan las bibliotecas de un sitio.
Configuración
Necesitas una credencial Microsoft Shared Point, que se conecta iniciando sesión con tu cuenta de Microsoft. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Microsoft Shared Point con la que se accede a tus sitios. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. Por defecto, Get Sites. |
| Search Query | Texto para buscar sitios. Puedes usar palabras sueltas (proyecto), * para todos los sitios accesibles, displayName:Informes o title:Marketing para buscar por nombre o título, o la dirección completa de un sitio. Si lo dejas vacío, se listan todos tus sitios. Solo en Get Sites. |
| Results Count | Cuántos sitios se devuelven como máximo. Por defecto, 50. Solo en Get Sites. |
| Site ID or Name | El identificador o el nombre del sitio. En Get Site by Identifier y Get Site Drives. |
Operaciones
| Operación | Qué hace |
|---|---|
Get Sites | Lista tus sitios o, si escribes un texto en Search Query, los que coinciden con él. |
Get Site by Identifier | Devuelve los datos de un sitio concreto. |
Get Root Site | Devuelve los datos del sitio principal de tu organización. |
Get Site Drives | Devuelve las bibliotecas de documentos de un sitio, con su identificador, nombre, tipo, enlace y el espacio total, usado y libre. |
Resultado
La salida Data devuelve un elemento por cada sitio o biblioteca, con su identificador, nombre, nombre visible, descripción, enlace y fechas de creación y modificación. Si una operación falla, la salida trae un elemento con el mensaje de error en lugar de detener el flujo.
Puedes pasar los identificadores a Documents o Lists con Mode en By Manual Entry. El componente también se puede conectar a un Agente como herramienta, para que el agente decida en qué sitio buscar. Ver Tool Mode.
Ejemplo
Una empresa quiere un asistente que encuentre documentos en el sitio de SharePoint de cada departamento.
- Añade un Agente y conéctale Sites como herramienta, con la credencial Microsoft Shared Point de la empresa.
- Conéctale también Documents como herramienta, con Mode en
By Manual Entry. - Cuando alguien pregunte por los documentos de Recursos Humanos, el agente busca el sitio con
Get Sites, obtiene sus bibliotecas conGet Site Drivesy lista los documentos con Documents.