Skill WorkIQ Copilot

Visão Geral

O WorkIQ (Prévia Pública) permite que o Copilot consulte dados do Microsoft 365 com linguagem natural. Ele suporta agendas, documentos, mensagens do Teams, threads de e-mail, acompanhamento de follow-ups, resumos de partes interessadas e muito mais. Use esta skill sempre que uma tarefa precisar de inteligência organizacional em tempo real além do repositório local.

Dados Suportados e Exemplos de Prompts

• E-mails – “Resuma os e-mails da Sarah sobre o orçamento.”
• Reuniões – “Quais são minhas próximas reuniões esta semana?”
• Documentos – “Encontre documentos recentes sobre o planejamento do Q4.”
• Teams – “Resuma as mensagens no canal de Engenharia hoje.”
• Pessoas/Projetos – “Quem está trabalhando no Projeto Alpha?”

Obtendo Acesso

1. Plugin Copilot CLI (preferencial)
   • copilot
   • /plugin marketplace add github/copilot-plugins
   • /plugin install workiq@copilot-plugins
   • Reinicie o Copilot CLI.
2. CLI Autônomo / Servidor MCP
   • npm install -g @microsoft/workiq (ou npx -y @microsoft/workiq mcp).
   • Execute workiq mcp para expor ferramentas MCP, se necessário.
3. Consentimento do Tenant
   • O primeiro uso solicita consentimento do administrador do Microsoft 365 (EULA + permissões). Não administradores devem contatar o administrador do tenant para aprovar, conforme o Guia de Habilitação para Administradores de Tenant.

Checklist Pré-Voo

• Execute Get-Command workiq para garantir que o binário esteja disponível.
• Aceite o EULA uma vez via workiq accept-eula.
• Confirme o tenant correto (-t <tenant-id> se for diferente do padrão common).
• Esteja pronto para concluir o login do dispositivo no navegador quando solicitado.

Fluxo de Trabalho Principal

1. Clarificar intenção – agenda, itens de ação, busca de documentos, busca de pessoas, resumo de riscos, etc.
2. Criar prompt preciso – inclua período, fonte ou tópico (ex: “Resuma posts do Teams no #eng de hoje”).
3. Executar comando – workiq ask --question "<prompt>" (use -q para atalho, se desejar).
4. Monitorar execução – respostas longas podem ser transmitidas; aguarde a resposta terminar antes de emitir solicitações adicionais.
5. Resumir e editar – destaque insights, anote conflitos/tarefas, evite colar links brutos, a menos que seja necessário.
6. Oferecer acompanhamentos – bloquear tempo, redigir notas, consultas mais profundas, etc.

Referência de Comandos

Padrões de Prompt

• Agenda: “O que está na minha agenda amanhã?”
• Itens de ação: “Resuma os follow-ups da sincronização de clientes de hoje.”
• Documentos: “Liste os PowerPoints sobre o roadmap Contoso FY26.”
• Comunicações: “O que meu gerente disse sobre o prazo?”
• Insights: “Quais bloqueios surgiram nas últimas três reuniões?”
• Planejamento: “Sugira blocos de foco para a tarde de terça-feira.”

Diretrizes de Resposta

• Mantenha os resumos concisos (2–3 frases), destacando carga, prioridades, bloqueios e próximos passos opcionais.
• Refira-se a reuniões/documentos genericamente, a menos que o usuário precise especificamente de links.
• Mencione se o WorkIQ pode continuar (ex: “O WorkIQ pode mostrar de quinta a domingo, se necessário”).
• Mapeie as ações sugeridas pelo WorkIQ para ofertas claras (bloquear tempo, enviar follow-up, solicitar gravação, executar consulta mais profunda).

Melhores Práticas

• Prefira prompts restritos para reduzir ruído; execute várias consultas, se necessário.
• Combine os resultados logicamente (agenda + conflitos + itens de ação) antes de responder.
• Respeite a privacidade: não exponha listas de participantes ou trechos confidenciais, a menos que explicitamente solicitado.
• Registre quais comandos foram executados para que etapas futuras possam referenciá-los (“Solicitou ao WorkIQ agenda + conflitos”).
• Use o modo MCP (workiq mcp) quando outro agente/fluxo de trabalho precisar de acesso direto à ferramenta.

Solução de Problemas

• CLI Ausente – instale via npm ou certifique-se de que o PATH esteja configurado; notifique o usuário se indisponível.

…