Visão geral da API de QI de Trabalho

A API Work IQ permite que os desenvolvedores criem aplicativos agenciais e baseados em IA que raciocinam com segurança sobre os dados do Microsoft 365, preservando as permissões, a conformidade e os controles de governança existentes.

O Work IQ fornece vários protocolos para interagir com agentes - Agent-to-Agent (A2A), Model Context Protocol (MCP) e REST - para que você possa escolher o protocolo que melhor se adapta à arquitetura do seu aplicativo ou agente.

Ao acessar ou usar as APIs do Microsoft Work IQ, você concorda com os Termos de Uso das APIs do Microsoft Work IQ.

O que é QI de trabalho?

O Work IQ é uma camada de inteligência do local de trabalho que combina dados do Microsoft 365 com compreensão contextual para que os agentes possam raciocinar sobre o trabalho e agir. Para obter uma visão geral completa dos recursos do Work IQ, consulte Visão geral do Work IQ.

Por que usar o Work IQ?

As integrações tradicionais de IA geralmente exigem a criação de pipelines personalizados para extrair, indexar e proteger dados corporativos. O Work IQ elimina essa complexidade ao fornecer:

• Fundamento empresarial seguro: O acesso aos dados do Microsoft 365 é automaticamente cortado por permissão e imposto por política.
• Modelos de interação flexíveis: Escolha entre APIs de conversa, delegação de agente ou acesso baseado em ferramenta.
• Redução da sobrecarga operacional: Não há necessidade de gerenciar repositórios de vetores, trabalhos de sincronização de dados ou imposição de conformidade personalizada.

Protocolos com suporte

O Work IQ é compatível com os seguintes protocolos:

Funcionalidade suportada

O QI de trabalho pode raciocinar sobre:

• Mensagens de email
• Dados de reuniões e calendário
• Documentos no OneDrive e no SharePoint
• Mensagens do Microsoft Teams
• People and organizational context
• Planos do Microsoft Planner
• Resultados da pesquisa corporativa

Escolha um protocolo

Use o guia a seguir para selecionar o protocolo correto.

Exemplos de API

Protocolo Agent-to-Agent (A2A)

Use o A2A para colaboração e delegação de agentes, onde os agentes operam de forma autônoma e trocam tarefas estruturadas em vez de simples chamadas de API. O Work IQ oferece suporte a A2A v1.0 e v0.3, expedidos por meio do cabeçalho da A2A-Version solicitação.

Exemplo de solicitação — sync (SendMessage)

POST https://workiq.svc.cloud.microsoft/a2a/
Authorization: Bearer {access-token}
Content-Type: application/json
A2A-Version: 1.0

{
  "jsonrpc": "2.0",
  "id": "<request-guid>",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "<message-guid>",
      "parts": [
        {
          "text": "What meetings do I have today?"
        }
      ],
      "metadata": {
        "Location": {
          "timeZoneOffset": -480,
          "timeZone": "America/Los_Angeles"
        }
      }
    }
  }
}

Resposta de exemplo

{
  "jsonrpc": "2.0",
  "id": "<request-guid>",
  "result": {
    "task": {
      "id": "<task-id>",
      "contextId": "ctx-1",
      "status": {
        "state": "TASK_STATE_COMPLETED"
      },
      "artifacts": [
        {
          "artifactId": "<artifact-id>",
          "name": "Answer",
          "parts": [
            {
              "text": "Today you have: 9 AM standup, 11 AM review with Dana, 2 PM customer call."
            }
          ]
        }
      ]
    }
  }
}

Conversas em várias etapas

Passe a contextId resposta anterior na próxima mensagem:

{
  "jsonrpc": "2.0",
  "id": "<request-guid-2>",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "<message-guid-2>",
      "contextId": "ctx-1",
      "parts": [
        {
          "text": "Tell me more about the 2 PM customer call."
        }
      ]
    }
  }
}

Características principais

• Envelope JSON-RPC necessário (jsonrpc, id, method, params)
• POST para a URL base — o nome do método está dentro do corpo, não do caminho da URL
• Dá suporte a erros síncronos (SendMessage)
• Várias voltas via contextId
• Location Metadados necessários para consultas sensíveis ao tempo

MCP (Remote Model Context Protocol)

Use o MCP remoto para expor o contexto de trabalho do Microsoft 365 como ferramentas para assistentes de IA executados em ambientes de desenvolvedor.

Local MCP

Instale a CLI do Microsoft Work IQ e configure-a como um servidor MCP local.

▶ Explore o MCP local na demonstração interativa

Exemplo de configuração do servidor MCP

{
  "workiq": {
    "type": "stdio",
    "command": "workiq",
    "args": ["mcp"]
  }
}

Exemplo de consulta baseada em agente

Prompt

Summarize recent discussions about project risks.

Invocação conceitual do MCP

{
  "tool": "workiq.search",
  "arguments": {
    "query": "project risks",
    "source": "teams"
  }
}

Resultado

{
  "results": [
    {
      "summary": "Recent discussions highlighted timeline and dependency risks."
    }
  ]
}

Características principais

• Otimizado para IDEs e CLIs
• Contexto puxado dinamicamente quando necessário
• Reduz a construção manual de prompts
• Servidor único com ferramentas consolidadas (em breve)

Autenticação e segurança

O Work IQ usa a autenticação delegada do Microsoft Entra ID.

• As solicitações são executadas no contexto do usuário conectado.
• Há suporte para fluxos OBO (em nome de).
• Não há suporte para a autenticação somente de aplicativo.
• As permissões, os rótulos de confidencialidade e as políticas de conformidade do Microsoft 365 são impostos automaticamente.

Caminho a seguir para um novo desenvolvimento

O Work IQ é a base recomendada para novos aplicativos agenciais e baseados em IA em dados do Microsoft 365. Crie novos desenvolvimentos nas APIs Work IQ para aproveitar protocolos unificados, governança integrada e investimento contínuo.

Requisitos de licenciamento

A API Work IQ é licenciada de acordo com o seu contrato que rege o uso dos Serviços Online da Microsoft, incluindo os Termos do Produto da Microsoft. Você paga pelo uso da API Work IQ por meio de um modelo baseado em uso que usa créditos do Copilot. Para obter mais informações, consulte Entender o faturamento baseado em uso e o gerenciamento de custos para créditos do Copilot.

Conteúdo relacionado

• Início rápido do Work IQ A2A
• Visão geral da API REST de QI de Trabalho
• Microsoft Work IQ CLI
• Termos de Uso das APIs do Microsoft Work IQ
• Entender o faturamento baseado em uso e o gerenciamento de custos para créditos do Copilot
• Gerenciamento de experiências de IA habilitadas por cobrança baseada em uso
• Configuração de descoberta para experiências de IA habilitadas por cobrança baseada em uso
• Experimente as APIs na demonstração interativa