Como usar o Work IQ pelo PowerShell e CLI: requisitos, instalação e primeiros testes

Nos dois primeiros artigos desta série, vimos o que é Work IQ e como preparar o SharePoint para criar uma base mais organizada, segura e útil para experiências com IA.

Agora, vamos para uma abordagem mais técnica: como utilizar o Work IQ pelo terminal, usando PowerShell e CLI.

Esse cenário é voltado principalmente para desenvolvedores, administradores, arquitetos Microsoft 365 e profissionais técnicos que desejam testar consultas ao contexto corporativo diretamente pela linha de comando ou conectar esse contexto a assistentes de IA por meio de MCP.

Antes de começar, é importante entender um ponto: o Work IQ CLI ainda está em preview. Isso significa que comandos, recursos e disponibilidade podem mudar até a versão final.

O que é o Work IQ CLI?

O Work IQ CLI é uma interface de linha de comando que permite consultar dados do Microsoft 365 Copilot usando linguagem natural.

Na prática, ele permite fazer perguntas sobre informações de trabalho, como:

• e-mails;
• reuniões;
• documentos;
• mensagens do Teams;
• pessoas;
• arquivos recentes;
• contexto de projetos;
• informações relacionadas ao ambiente Microsoft 365.

Além do modo CLI, ele também pode funcionar como um servidor MCP, permitindo que assistentes de IA em ambientes de desenvolvimento acessem contexto corporativo de forma mais integrada.

Em termos simples:

• CLI mode: você faz perguntas diretamente no terminal;
• MCP server mode: um assistente de IA usa o Work IQ como fonte de contexto.

Quando faz sentido usar o Work IQ pelo PowerShell?

O uso pelo PowerShell faz sentido quando o objetivo é testar comandos, validar autenticação, consultar informações do Microsoft 365 ou preparar uma integração com ferramentas de desenvolvimento.

Exemplos de uso:

• localizar documentos recentes;
• resumir mensagens ou reuniões;
• buscar contexto de um projeto;
• consultar informações de pessoas;
• testar o Work IQ antes de conectar a um agente;
• validar o comportamento do MCP em ambiente técnico;
• apoiar desenvolvedores com contexto de negócio durante a implementação.

Esse não é o primeiro caminho para usuários comuns. Para usuários finais, o contato mais natural com ele acontece por meio do Microsoft 365 Copilot, Copilot Chat, Teams, Outlook e experiências integradas.

Requisitos antes da instalação

Antes de instalar o Work IQ CLI, valide os requisitos.

Você precisará de:

• uma máquina Windows, macOS ou Linux;
• PowerShell ou outro terminal;
• Node.js instalado;
• npm disponível no terminal;
• uma assinatura Microsoft 365 com licença de Copilot;
• acesso ao tenant Microsoft 365 da organização;
• consentimento administrativo no Microsoft Entra ID;
• permissão para usar o Work IQ no ambiente.

No Windows, o PowerShell é uma boa opção para executar os comandos.

Também é possível usar Windows Terminal, Prompt de Comando, terminal do VS Code ou WSL, desde que o ambiente tenha suporte ao Node.js e ao navegador para autenticação.

Passo 1: verificar se o Node.js está instalado

Abra o PowerShell e execute:

node -v

Depois, verifique o npm:

npm -v

Se os comandos retornarem uma versão, o Node.js e o npm estão instalados.

Exemplo:

v22.11.0

10.9.0

Se o terminal informar que o comando não foi reconhecido, instale o Node.js antes de continuar.

Passo 2: instalar o Work IQ CLI

A instalação global pode ser feita com npm.

No PowerShell, execute:

npm install -g @microsoft/workiq

Esse comando instala o Work IQ CLI globalmente na máquina.

Depois da instalação, valide se o comando está disponível:

workiq version

Se a instalação estiver correta, o terminal deve retornar a versão instalada.

Passo 3: aceitar o contrato de licença

Antes do primeiro uso, aceite o contrato de licença do Work IQ.

Execute:

workiq accept-eula

Esse passo é necessário para liberar o uso inicial da ferramenta.

Passo 4: entender o consentimento administrativo

Este é um dos pontos mais importantes.

O Work IQ CLI acessa dados do Microsoft 365 no contexto do usuário autenticado. Para isso, a aplicação precisa de permissões no Microsoft Entra ID.

Em muitos ambientes corporativos, esse consentimento precisa ser concedido por um administrador.

Se você não for administrador do tenant, provavelmente precisará acionar a equipe de TI para aprovar o uso.

Sem esse consentimento, é comum encontrar erros como:

• acesso negado;
• permissão insuficiente;
• escopo ausente;
• falha de autenticação;
• licença não encontrada.

Esse comportamento é esperado em ambientes corporativos mais controlados.

Passo 5: executar uma consulta simples

Depois de instalar e aceitar a licença, você pode testar uma pergunta usando o comando workiq ask.

Exemplo:

workiq ask -q "Find my recent documents about planning"

Outro exemplo:

workiq ask -q "What meetings do I have today?"

Ou:

workiq ask -q "Summarize my recent emails about the budget"

O comando envia a pergunta para o Work IQ e retorna uma resposta baseada no contexto disponível para o usuário autenticado.

A resposta depende dos dados acessíveis no Microsoft 365 e das permissões configuradas no tenant.

Passo 6: consultar documentos recentes

Um cenário prático é buscar documentos recentes relacionados a um tema.

Exemplo:

workiq ask -q "Find my recent documents about onboarding"

Esse tipo de consulta pode ajudar em situações como:

• localizar arquivos trabalhados recentemente;
• encontrar documentos de um projeto;
• recuperar apresentações;
• buscar materiais relacionados a uma reunião;
• identificar arquivos compartilhados por uma equipe.

Se os documentos estiverem bem organizados no SharePoint ou OneDrive, a chance de obter uma resposta útil aumenta.

Passo 7: consultar contexto de reuniões

Outro uso prático é consultar informações relacionadas a reuniões.

Exemplo:

workiq ask -q "Summarize my meetings from today and list the main action items"

Esse comando pode ajudar a recuperar pontos discutidos, decisões e próximos passos, dependendo dos dados disponíveis no ambiente.

Esse tipo de uso mostra a diferença entre uma busca comum e uma experiência baseada em contexto de trabalho.

Passo 8: usar o Work IQ em modo MCP

Além do modo CLI, o Work IQ pode ser executado como servidor MCP.

MCP significa Model Context Protocol. Ele permite que assistentes de IA se conectem a ferramentas e fontes de contexto.

Para iniciar o Work IQ em modo MCP, execute:

workiq mcp

Também é possível executar sem instalação global usando npx:

npx -y @microsoft/workiq mcp

Esse modo é útil para integrar o Work IQ a assistentes de IA em ambientes de desenvolvimento, como VS Code ou ferramentas compatíveis com MCP.

Na prática, o assistente pode usar o Work IQ para buscar contexto do Microsoft 365 enquanto o desenvolvedor trabalha.

Passo 9: configuração manual de MCP

Em algumas ferramentas, é possível configurar o Work IQ como servidor MCP por meio de um arquivo de configuração.

Um exemplo de configuração seria:

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

Essa configuração informa à ferramenta que o Work IQ deve ser iniciado usando npx e que as ferramentas disponíveis podem ser expostas ao assistente.

A localização desse arquivo depende da ferramenta utilizada.

Passo 10: testar um cenário realista

Depois de configurar o CLI ou MCP, teste com perguntas próximas do uso real.

Documentos:

workiq ask -q "Find documents related to the customer portal project and summarize the main requirements"

Reuniões:

workiq ask -q "What decisions were made in my last meeting about the customer portal?"

Mensagens:

workiq ask -q "Summarize recent Teams messages about the deployment issue"

Pessoas:

workiq ask -q "Who is working on Project Alpha?"

Esses testes ajudam a validar se o Work IQ está conseguindo acessar o contexto esperado.

Conclusão

O Work IQ CLI permite que desenvolvedores e profissionais técnicos consultem informações do Microsoft 365 diretamente pelo terminal, usando linguagem natural.

Com PowerShell, Node.js e npm, é possível instalar a ferramenta, aceitar o contrato de licença, executar perguntas com workiq ask e iniciar o modo MCP com workiq mcp.

Esse recurso é especialmente útil para validar cenários técnicos, testar contexto corporativo e preparar integrações com assistentes de IA.

Leve o Work IQ além do conceito: fale com a Trinapse e veja como preparar SharePoint, Microsoft 365 e agentes de IA para cenários práticos com Copilot e automação inteligente.