Conectar um projeto do Microsoft Foundry ao Work IQ

Use uma conexão Work IQ em um projeto do Microsoft Foundry para permitir que um agente do Foundry use o contexto do Microsoft 365 de emails, reuniões, arquivos, chats e outros dados de trabalho. Depois de criar a conexão do projeto, você pode adicionar o Work IQ a um agente ou caixa de ferramentas e usá-lo em prompts. As solicitações são executadas no contexto do usuário conectado e respeitam as permissões, os rótulos de confidencialidade e a política de locatário do Microsoft 365.

Este início rápido resume o fluxo de conexão no nível do projeto. Para obter o artigo completo do Foundry e exemplos de SDK, consulte Conectar agentes ao Microsoft 365 com o Work IQ.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Um projeto do Microsoft Foundry com um modelo implantado.
  • A função de Gerente de Projeto do Foundry no projeto do Foundry para criar a conexão do Work IQ.
  • A função Usuário do Foundry no projeto Foundry para a identidade do desenvolvedor, a identidade do tempo de execução do agente e os usuários envolvidos nos fluxos do OAuth.
  • Uma licença do Microsoft 365 Copilot para cada usuário que chama o Work IQ por meio do seu agente.
  • Um Administrador Global do Microsoft Entra que pode conceder consentimento de administrador para a WorkIQAgent.Ask permissão delegada.

Observação

As conexões do Work IQ no Foundry usam a autenticação delegada do Microsoft Entra. Não há suporte para a autenticação somente de aplicativo.

Configurar seu aplicativo Microsoft Entra

Um administrador do Entra deve criar ou configurar um registro de aplicativo antes de criar a conexão Work IQ no Foundry.

  1. No centro de administração do Microsoft Entra, vá para ID do Entra> Registros de aplicativo.
  2. Crie um novo registro de aplicativo ou abra um registro de aplicativo existente para seu agente Foundry.
  3. Copie a ID do aplicativo (cliente) e a ID do diretório (locatário).
  4. Adicione um segredo do cliente e copie o valor do segredo.
  5. Em permissões de API, adicione a permissão WorkIQAgent.Askdelegada Work IQ.
  6. Selecione Conceder consentimento do administrador para o locatário.

Se o Work IQ não aparecer quando você pesquisar permissões de API, talvez a entidade de serviço do Work IQ não esteja provisionada em seu locatário. Para obter diretrizes de configuração, consulte Habilitar APIs do Work IQ.

Conecte a ferramenta Work IQ MCP no Foundry

Conecte o servidor remoto Work IQ MCP como uma ferramenta em seu projeto Foundry.

  1. Abra seu projeto no Microsoft Foundry.

  2. Na navegação à esquerda, selecione Ferramentas.

  3. Na página Ferramentas , selecione a guia Ferramentas .

  4. Selecione Conectar uma ferramenta.

  5. Em Selecionar uma ferramenta, selecione a guia Catálogo .

  6. Pesquise por QI de Trabalho MCP.

  7. Selecione Work IQ MCP e, em seguida, selecione Criar.

  8. Confirme ou insira o ponto de extremidade MCP do Work IQ.

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

  9. Configure o OAuth com os valores do registro do aplicativo.

    Campo Valor
    ID do cliente ID do aplicativo (cliente) do registro do aplicativo
    Segredo do cliente Valor do segredo do cliente do registro do aplicativo
    URL de autorização https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
    Token URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    Atualizar URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    Escopos api://workiq.svc.cloud.microsoft/WorkIQAgent.Ask,offline_access

  10. Substitua {tenant-id} pela ID do diretório (locatário) do registro do aplicativo.

  11. Salve a conexão da ferramenta.

Adicionar o URI de redirecionamento ao registro do aplicativo

Depois que o Foundry cria a conexão da ferramenta, ele exibe uma URL de redirecionamento OAuth. Adicione essa URL ao seu registro de aplicativo.

  1. No centro de administração do Microsoft Entra, abra o registro do aplicativo.
  2. Selecione Autenticação>Adicionar uma plataforma>Web.
  3. Cole a URL de redirecionamento OAuth da conexão da ferramenta Foundry em URIs de redirecionamento.
  4. Selecione Configurar.

Adicionar QI de trabalho a um agente

Depois que a conexão da ferramenta MCP do Work IQ estiver disponível no projeto, adicione o Work IQ a um agente.

  1. Abra o projeto Foundry.
  2. Abra o agente que deve usar o contexto do Microsoft 365.
  3. Adicione a ferramenta Work IQ MCP ao agente ou adicione-a a uma caixa de ferramentas que o agente usa.
  4. Selecione a conexão da ferramenta Work IQ que você criou.
  5. Se o Foundry solicitar que você configure o acesso à ferramenta MCP, permita as ferramentas do Work IQ que o agente deve ser capaz de chamar. Você também pode escolher se as chamadas de ferramenta MCP exigem aprovação ou são aprovadas automaticamente, com base na revisão da organização e nos requisitos de segurança.
  6. Salve ou publique a configuração do agente.

Experimentar um prompt do QI de Trabalho

Faça uma pergunta ao seu agente Foundry que exija contexto do Microsoft 365. Na primeira vez que um usuário envia um prompt que usa o Work IQ, o Foundry pode solicitar que o usuário entre e consinta com o acesso.

Por exemplo:

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.

O Foundry encaminha a solicitação para o Work IQ. O Work IQ recupera e raciocina sobre os dados do Microsoft 365 do usuário e, em seguida, retorna uma resposta fundamentada ao agente.

A resposta depende das permissões do usuário conectado ao Microsoft 365, das permissões OAuth do aplicativo e da política de locatário.

Conteúdo relacionado

  • Last updated on