Conexión de un proyecto de Microsoft Foundry a Work IQ

Use una conexión work IQ en un proyecto de Microsoft Foundry para permitir que un agente de Foundry use el contexto de Microsoft 365 a partir de correos electrónicos, reuniones, archivos, chats y otros datos de trabajo. Después de crear la conexión del proyecto, puede agregar Work IQ a un agente o cuadro de herramientas y usarlo en los mensajes. Las solicitudes se ejecutan en el contexto del usuario que ha iniciado sesión y respetan los permisos, las etiquetas de confidencialidad y la directiva de inquilino de Microsoft 365.

En este inicio rápido se resume el flujo de conexión de nivel de proyecto. Para ver el artículo completo de Foundry y los ejemplos del SDK, consulte Conexión de agentes a Microsoft 365 con Work IQ.

Requisitos previos

Antes de empezar, asegúrese de que tiene:

  • Un proyecto de Microsoft Foundry con un modelo implementado.
  • Rol de Foundry Project Manager en el proyecto Foundry para crear la conexión work IQ.
  • El rol Usuario de Foundry en el proyecto Foundry para la identidad del desarrollador, la identidad del entorno de ejecución del agente y los usuarios implicados en los flujos de OAuth.
  • Una licencia de Microsoft 365 Copilot para cada usuario que llama a Work IQ a través del agente.
  • Un Microsoft Entra administrador global que puede conceder el consentimiento del administrador para el WorkIQAgent.Ask permiso delegado.

Nota:

Las conexiones de IQ de trabajo en Foundry usan la autenticación Microsoft Entra delegada. No se admite la autenticación solo de aplicación.

Configuración de la aplicación de Microsoft Entra

Un administrador de Entra debe crear o configurar un registro de aplicación antes de crear la conexión de Work IQ en Foundry.

  1. En el Centro de administración Microsoft Entra, vaya a id. de Entra>Registros de aplicaciones.
  2. Cree un nuevo registro de aplicación o abra un registro de aplicación existente para el agente de Foundry.
  3. Copie el identificador de aplicación (cliente) y el identificador de directorio (inquilino).
  4. Agregue un secreto de cliente y copie el valor del secreto.
  5. En Permisos de API, agregue el permiso WorkIQAgent.Askdelegado de Work IQ .
  6. Seleccione Conceder consentimiento de administrador para el inquilino.

Si Work IQ no aparece al buscar permisos de API, es posible que la entidad de servicio de Work IQ no se aprovisione en el inquilino. Para obtener instrucciones de configuración, consulte Habilitar las API de Work IQ.

Conexión de la herramienta WORK IQ MCP en Foundry

Conecte el servidor MCP de Work IQ remoto como una herramienta en el proyecto de Foundry.

  1. Abra el proyecto en Microsoft Foundry.

  2. En el panel de navegación izquierdo, seleccione Herramientas.

  3. En la página Herramientas , seleccione la pestaña Herramientas .

  4. Seleccione Conectar una herramienta.

  5. En Seleccionar una herramienta, seleccione la pestaña Catálogo .

  6. Busque Trabajo IQ MCP.

  7. Seleccione Work IQ MCP (McP de IQ de trabajo) y, a continuación, seleccione Crear.

  8. Confirme o escriba el punto de conexión MCP de Work IQ.

    https://workiq.svc.cloud.microsoft/mcp

  9. Configure OAuth con los valores del registro de la aplicación.

    Campo Valor
    Id. de cliente Identificador de aplicación (cliente) del registro de la aplicación
    Secreto de cliente Valor de secreto de cliente del registro de la aplicación
    Dirección URL de autorización https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
    Token URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    Dirección URL de actualización https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    Scopes api://workiq.svc.cloud.microsoft/WorkIQAgent.Ask,offline_access

  10. Reemplace por {tenant-id} el identificador de directorio (inquilino) del registro de la aplicación.

  11. Guarde la conexión de la herramienta.

Agregar el URI de redireccionamiento al registro de la aplicación

Una vez que Foundry crea la conexión de la herramienta, muestra una dirección URL de redireccionamiento de OAuth. Agregue esta dirección URL al registro de la aplicación.

  1. En el Centro de administración Microsoft Entra, abra el registro de la aplicación.
  2. Seleccione Autenticación>Agregar una plataforma>web.
  3. Pegue la dirección URL de redireccionamiento de OAuth desde la conexión de la herramienta Foundry en URI de redireccionamiento.
  4. Seleccione Configurar.

Adición de Work IQ a un agente

Una vez que la conexión de la herramienta WORK IQ MCP esté disponible en el proyecto, agregue Work IQ a un agente.

  1. Abra el proyecto Foundry.
  2. Abra el agente que debe usar el contexto de Microsoft 365.
  3. Agregue la herramienta WORK IQ MCP al agente o agréguela a un cuadro de herramientas que use el agente.
  4. Seleccione la conexión de la herramienta Work IQ que creó.
  5. Si Foundry le pide que configure el acceso a la herramienta MCP, permita las herramientas de Work IQ a las que el agente debe poder llamar. También puede elegir si las llamadas a herramientas MCP requieren aprobación o se aprueban automáticamente, en función de los requisitos de revisión y seguridad de su organización.
  6. Guarde o publique la configuración del agente.

Pruebe un símbolo del sistema de IQ de trabajo

Formule al agente de Foundry una pregunta que requiera el contexto de Microsoft 365. La primera vez que un usuario envía un mensaje que usa Work IQ, Foundry podría pedir al usuario que inicie sesión y dé su consentimiento para acceder.

Por ejemplo:

Summarize my upcoming meetings for today.

Find recent messages from my manager from this week.

Retrieve the latest email related to the quarterly business review.

Foundry enruta la solicitud a Work IQ. Work IQ recupera y explica los datos de Microsoft 365 del usuario y, a continuación, devuelve una respuesta fundamentada al agente.

La respuesta depende de los permisos de Microsoft 365 del usuario que ha iniciado sesión, los permisos de OAuth de la aplicación y la directiva de inquilino.

Contenido relacionado

  • Last updated on