Descrição geral da API de QI de Trabalho (pré-visualização)

A API de QI de Trabalho permite que os programadores criem aplicações com tecnologia de IA e agente que raciocinam de forma segura sobre os dados do Microsoft 365, preservando as permissões, a conformidade e os controlos de governação existentes.

O IQ de Trabalho fornece vários protocolos para interagir com agentes - Agente a Agente (A2A), Protocolo de Contexto de Modelo (MCP) e REST – para que possa escolher o protocolo mais adequado à arquitetura da sua aplicação ou agente. Nesta pré-visualização pública, A2A e MCP local estão disponíveis atualmente; O REST e o MCP remoto estão disponíveis em breve.

Ao aceder ou utilizar as APIs do IQ do Microsoft Work, está a concordar com os Termos de Utilização (pré-visualização) das APIs de IQ do Microsoft Work.

O que é o IQ de Trabalho?

O QI de Trabalho é a camada de inteligência por trás de Microsoft 365 Copilot e agentes. Ao contrário dos sistemas que simplesmente obtêm conteúdo, compreende como o trabalho realmente acontece. Combina dados do Microsoft 365 (e-mails, reuniões, documentos, conversas) com memória de padrões, preferências e relações. Aplica a inferência necessária à razão em todas as mesmas e apresenta as melhores ações seguintes. O QI de Trabalho orquestra todas as camadas de inteligência - desde reunir contexto a respostas de base, selecionar competências e invocar ferramentas - ao mesmo tempo que honra as permissões e a governação empresariais.

Todos os pedidos do IQ de Trabalho:

  • Executar no contexto do utilizador com sessão iniciada
  • Respeitar as permissões e etiquetas de confidencialidade do Microsoft 365
  • Permanecer dentro do limite de fidedignidade do Microsoft 365

Isto permite que as aplicações raciocinam sobre os dados de trabalho sem exportar ou duplicar conteúdo.

Porquê utilizar o IQ de Trabalho?

As integrações de IA tradicionais exigem frequentemente a criação de pipelines personalizados para extrair, indexar e proteger dados empresariais. O QI de Trabalho elimina esta complexidade ao fornecer:

  • Base empresarial segura: O acesso aos dados do Microsoft 365 é automaticamente limitado à permissão e imposto pela política.
  • Modelos de interação flexíveis: Escolha entre APIs de conversação, delegação de agente ou acesso baseado em ferramentas.
  • Sobrecarga operacional reduzida: Não é necessário gerir arquivos de vetores, tarefas de sincronização de dados ou imposição de conformidade personalizada.

Protocolos suportados

O IQ de Trabalho suporta os seguintes protocolos:

Protocolo Descrição Cenários típicos
A2A Comunicação agente a agente estruturada Sistemas multi-agentes, delegação
Local MCP Acesso ao contexto baseado em ferramentas IDEs, CLIs, assistentes de codificação de IA
MCP Remoto Acesso ao contexto baseado em ferramentas IDEs, CLIs, assistentes de codificação de IA
REST API de conversação, pedido/resposta Agentes alojados no serviço, orquestradores

Funcionalidade suportada

O QI de Trabalho pode fazer o seguinte:

  • Mensagens de email
  • Reuniões e dados do calendário
  • Documentos no OneDrive e no SharePoint
  • Mensagens do Microsoft Teams
  • People e contexto organizacional
  • Resultados da pesquisa empresarial

Escolher um protocolo

Utilize o guia abaixo para selecionar o protocolo correto.

Observação

A tabela seguinte contém recomendações para o protocolo mais adequado para cenários específicos e não regras estritas. Utilize o protocolo que funciona melhor para si.

A2A API REST (brevemente) MCP
Utilizar quando Outro agente tem de delegar uma tarefa ao IQ de Trabalho e obter resultados de volta Está a criar uma aplicação ou serviço que chama o IQ do Trabalho através de programação Uma assistente de IA (Copilot, Claude, etc.) tem de invocar o IQ de Trabalho como uma ferramenta para o utilizador
Caller Outro agente A sua aplicação ou back-end Um cliente baseado em LLM
Exemplo "O nosso agente de operações pede ao IQ do Trabalho para investigar uma regressão." "A minha aplicação Web envia uma pergunta para o IQ de Trabalho e compõe a resposta." "Um utilizador faz uma pergunta ao Copilot e chama o IQ do Trabalho para responder."

Exemplos de API

Protocolo Agente a Agente (A2A)

Utilize A2A para colaboração e delegação de agentes, em que os agentes operam de forma autónoma e trocam tarefas estruturadas em vez de chamadas simples à API. O QI de Trabalho suporta A2A v1.0 e v0.3, enviados através do cabeçalho do A2A-Version pedido.

Gateway de IQ de Trabalho

  • Ponto final: https://workiq.svc.cloud.microsoft/a2a/
  • Público-alvo do token: api://workiq.svc.cloud.microsoft
  • Escopo: WorkIQAgent.Ask

Pedido de exemplo — sincronizar (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"
        }
      }
    }
  }
}

Observação

O A2A-Version: 1.0 cabeçalho é necessário para utilizar nomes de métodos v1.0 (SendMessage). Omiti-lo é predefinido para v0.3.

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."
            }
          ]
        }
      ]
    }
  }
}

Conversações multiturno

Transmita o contextId da resposta anterior na mensagem seguinte:

{
  "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 URL base — o nome do método está dentro do corpo, não o caminho do URL
  • Suporta síncrono (SendMessage)
  • Multi-turn via contextId
  • Location metadados necessários para consultas sensíveis ao tempo

Protocolo MCP (Remote Model Context Protocol)

Utilize o MCP para expor o contexto de trabalho do Microsoft 365 como ferramentas para assistentes de IA em execução em ambientes de programador.

Importante

  • Estado atual: Atualmente, o contexto de trabalho do Microsoft 365 está disponível através de servidores MCP individuais para cargas de trabalho específicas.
  • Brevemente: Um único servidor mcP do IQ de Trabalho remoto unificado irá consolidá-los num único servidor com um conjunto organizado de ferramentas e competências, simplificando a configuração e proporcionando uma experiência consistente de programador.

Local MCP

Instale a CLI do Microsoft Work IQ (pré-visualização) e configure-a como um servidor MCP local.

▶ Veja-o em ação na Demonstração Interativa (pré-visualização)

Exemplo de configuração do servidor MCP

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

Consulta baseada no agente de exemplo

Prompt

Summarize recent discussions about project risks.

Invocação conceptual 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
  • O contexto foi extraído dinamicamente quando necessário
  • Reduz a construção manual de pedidos
  • Servidor único com ferramentas consolidadas (brevemente)

Autenticação e segurança

O QI de Trabalho utiliza Microsoft Entra ID autenticação delegada.

  • Os pedidos são executados no contexto do utilizador com sessão iniciada
  • Os fluxos em nome de (OBO) são suportados
  • A autenticação apenas da aplicação não é suportada
  • As permissões, as etiquetas de confidencialidade e as políticas de conformidade do Microsoft 365 são impostas automaticamente

How Work IQ compares to Copilot Chat API (How Work IQ compares to Copilot Chat API)

O QI de Trabalho é a evolução pronta para produção da API Copilot Chat. Quando o IQ de Trabalho atinge a disponibilidade geral (maio de 2026), torna-se a forma recomendada e totalmente suportada de integrar com o agente Copilot em cenários de produção. É apoiado por SLAs empresariais, contratos estáveis e compromissos de suporte a longo prazo.

O que isso significa para você:

  • Os novos projetos devem basear-se no QI de Trabalho a partir do primeiro dia.
  • As integrações existentes com a API Copilot Chat continuarão a funcionar. A API Copilot Chat permanecerá em pré-visualização pública para experimentação e desenvolvimento em fase inicial, mas não é abrangida por SLAs de produção.
  • Migrar é simples – o IQ de Trabalho preserva os conceitos que já conhece e adiciona a fiabilidade, governação e garantias de suporte necessárias para cargas de trabalho de produção.

Recomendamos que planeie a sua mudança para o IQ de Trabalho antes do lançamento do produto para tirar o máximo partido do suporte de produção no lançamento.

Conteúdo relacionado

  • Last updated on