Microsoft Work IQ CLI

O Microsoft Work IQ é um servidor de interface de linha de comando (CLI) e MCP (Protocolo de Contexto de Modelo) que conecta assistentes de IA aos seus dados do Microsoft 365 Copilot. O Work IQ permite que você consulte seus emails, reuniões, documentos, mensagens do Teams, insights do local de trabalho, informações relacionadas a pessoas e muito mais usando linguagem natural.

Ao usar o Work IQ, você pode fazer perguntas como:

  • "O que meu gerente disse sobre o prazo do projeto?"
  • "Encontre meus documentos recentes sobre o planejamento do T4"
  • "Resuma as mensagens de hoje no canal de Engenharia e proponha um plano de ação"

O que é a CLI de QI de trabalho?

A CLI do Work IQ preenche a lacuna entre os assistentes de codificação de IA e seus dados do Microsoft 365. Ao expor seus dados do Microsoft 365 Copilot por meio do Protocolo de Contexto de Modelo, o Work IQ permite que os assistentes de IA em seu ambiente de desenvolvimento acessem e analisem as informações do seu local de trabalho.

Os principais recursos incluem:

Tipo de dados Consultas de exemplo
Emails "O que John disse sobre a proposta?"
Reuniões "O que tem no meu calendário amanhã?"
Documentos "Find my recent PowerPoint presentations"
Mensagens do Teams "Resuma as mensagens de hoje no canal de Engenharia"
Pessoas "Quem está trabalhando no Projeto Alpha?"

Para obter mais informações, consulte o repositório do GitHub do Microsoft Work IQ.

Como funciona o Work IQ

A CLI do Work IQ opera em dois modos:

  • Modo CLI: Execute consultas diretamente do seu terminal usando comandos como workiq ask.
  • Modo de servidor MCP: integre-se a assistentes de IA como o GitHub Copilot no VS Code ou na CLI, permitindo que seu assistente de codificação acesse seus dados do Microsoft 365 contextualmente.

O modo de servidor MCP é poderoso porque permite que seu assistente de IA puxe automaticamente o contexto relevante do local de trabalho quando você estiver trabalhando no código. Por exemplo, se você estiver implementando um recurso discutido em uma reunião recente, seu assistente de IA poderá acessar esse contexto de reunião para fornecer sugestões mais relevantes e até mesmo iniciar a implementação.

Pré-requisitos

Observação

Para acessar os dados da organização do Microsoft 365, a CLI do Work IQ e o servidor MCP precisam receber permissões que exigem direitos administrativos na organização. Se você não for um administrador da organização, entre em contato com ele para fornecer acesso. Para obter mais informações sobre consentimento, consulte Visão geral do consentimento de usuários e administradores.

Suporte à plataforma

O Work IQ é compatível com as seguintes plataformas:

  • Windows (x64 e ARM64)
  • Linux (x64 e ARM64)
  • macOS (x64 e ARM64)
  • Subsistema do Windows para Linux (WSL) com suporte ao navegador

Instalar o Work IQ

Você pode instalar o Work IQ globalmente usando npm ou executá-lo diretamente usando npx.

Capacidade de suporte

Após a disponibilidade geral do Work IQ em 16 de junho de 2026, todos os clientes que usam versões prévias da CLI do Work IQ devem atualizar para uma versão GA com suporte. As solicitações de suporte primeiro exigem a reprodução do problema em um build GA. O suporte para versões de visualização publicadas antes de 16 de junho de 2026, como a versão 0.4.x ou 0.5.x, não é mais oferecido.

Instalar usando a CLI do GitHub Copilot

A maneira mais rápida de começar é usando a CLI do GitHub Copilot:

  1. Abra a CLI do GitHub Copilot.

    copilot

  2. Adicione o marketplace de plug-ins (configuração única).

    /plugin marketplace add github/copilot-plugins

  3. Instale o Work IQ.

    /plugin install workiq@copilot-plugins

  4. Reinicie a CLI do Copilot e comece a consultar seus dados do Microsoft 365.

    You: What are my upcoming meetings this week?
You: Summarize emails from Sarah about the budget
You: Find documents I worked on yesterday

Instalar globalmente usando npm

npm install -g @microsoft/workiq

Atualize globalmente usando npm

npm update -g @microsoft/workiq

Execute usando npx (sem necessidade de instalação)

npx -y @microsoft/workiq mcp

Instalar no VS Code

Use os links a seguir para adicionar o Work IQ como um servidor MCP no VS Code:

Configuração manual do MCP

Adicione a seguinte configuração ao arquivo de configurações do MCP.

▶ Configure com a Demonstração Interativa

{
  "workiq": {
    "command": "npx",
    "args": [
      "-y",
      "@microsoft/workiq",
      "mcp"
    ],
    "tools": [
      "*"
    ]
  }
}

Aceite o Contrato de Licença do Usuário Final

Antes de usar o Work IQ pela primeira vez, você deve aceitar o Contrato de Licença de Usuário Final (EULA):

workiq accept-eula

Referência CLI

Comandos

Comando Descrição
workiq accept-eula Aceite o Contrato de Licença de Usuário Final (EULA)
workiq ask Faça uma pergunta a um agente específico ou execute em modo interativo
workiq mcp Iniciar o servidor MCP stdio para comunicação do agente
workiq version Mostrar informações da versão

Opções globais

Opção Descrição Padrão
-t, --tenant-id <tenant-id> A ID de locatário do Microsoft Entra a ser usada para autenticação common
--version Mostrar informações da versão
-?, -h, --help Mostrar informações de ajuda e uso

Opções de Solicitação do WorkIQ

Opção Descrição
-q, --question <question> A pergunta a ser feita ao agente

Cenários principais

Os cenários a seguir demonstram como o Work IQ pode ajudá-lo a ser mais produtivo conectando seu assistente de IA aos dados do local de trabalho.

Cenário 1: Localizando o contexto do projeto durante a codificação

Quando você implementa um recurso que foi discutido em reuniões ou emails, o Work IQ ajuda seu assistente de IA a entender o contexto de negócios por trás do código que você está escrevendo.

Usar a CLI

workiq ask -q "What requirements did Sarah share about the customer portal authentication feature?"

Usar o GitHub Copilot no VS Code

Ao escrever o código, pergunte: "Quais requisitos de autenticação minha equipe discutiu para o portal do cliente? Verifique minhas reuniões e emails."

Seu assistente de IA recupera:

  • Anotações da reunião em que o recurso foi discutido
  • Emails com requisitos técnicos
  • Documentos compartilhados com especificações
  • Comentários e decisões da equipe

Esse contexto ajuda o assistente de IA a fornecer sugestões de código mais relevantes alinhadas com as decisões da sua equipe.

Cenário 2: iniciar a implementação do recurso com base em documentos de especificação

Você começa a trabalhar em um novo recurso com base em um documento de especificação armazenado no SharePoint. O Work IQ resume os principais recursos e requisitos e permite que seu assistente de codificação de IA crie implementações de linha de base.

Usar a CLI

workiq ask -q "Summarize the key requirements and features outlined in the specification document for the user portal testing sandbox."

Usar o GitHub Copilot no VS Code

Pergunte ao seu assistente de IA: "Crie um novo projeto do ASP.NET Core com base no documento de especificação da área restrita de teste do portal do usuário".

O Work IQ pesquisa seus dados do Microsoft 365 e fornece um resumo dos principais requisitos e recursos. Com o GitHub Copilot, um novo projeto é criado com implementações baseadas nas especificações.

Cenário 3: Analisar os comentários dos clientes para fazer alterações no código

Durante uma reunião do Microsoft Teams com o cliente, vários problemas foram levantados pelo administrador de TI do cliente que devem ser corrigidos. O Work IQ pode organizar e resumir os comentários das anotações da reunião e permitir que seu assistente de codificação de IA recomende correções.

Usar a CLI

workiq ask

Esse comando inicia o modo interativo no qual você pode ter uma conversa:

You: What were the specific issues raised by Alex in yesterday's meeting with Contoso?
You: Were any of these issues flagged as blocking the rollout?

Usar o GitHub Copilot no VS Code

Pergunte ao seu assistente de IA: "Quais foram os problemas específicos levantados por Alex na reunião de ontem com a Contoso? Identifique o problema mais crítico e sugira uma correção."

O Work IQ pesquisa as anotações da reunião geradas pelo facilitador para identificar os problemas específicos levantados pelo cliente e se algum deles foi sinalizado como crítico ou bloqueador.

Segurança e privacidade

O Work IQ herda todas as proteções de dados fornecidas pelo Microsoft 365 Copilot:

  • Segurança de nível empresarial: todo o acesso aos dados segue as políticas de segurança da sua organização.
  • Respeito pelas permissões: o Work IQ só pode acessar os dados que você já tem permissão para visualizar.
  • Administração visibilidade: os administradores corporativos têm visibilidade e controle sobre o uso do Work IQ em sua organização.
  • Sem armazenamento de dados: o Work IQ não armazena seus dados do Microsoft 365. Ele recupera informações sob demanda quando você faz consultas.

Faça comentários

O Work IQ é uma ferramenta proprietária, mas a equipe de desenvolvimento agradece o feedback da comunidade. Use a página de problemas do GitHub para:

  • Crie relatórios de bugs com base na sua experiência
  • Forneça comentários sobre comportamento documentado e APIs
  • Sugerir recursos ou melhorias de produtos
  • Compartilhar insights sobre a experiência do desenvolvedor ou cenários de integração

Conteúdo relacionado

  • Last updated on