Descrição geral da API de QI de Trabalho

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 MCP (Model Context Protocol) e REST – para que possa escolher o protocolo mais adequado à arquitetura da sua aplicação ou agente.

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

O que é o IQ de Trabalho?

O QI de Trabalho é uma camada de inteligência no local de trabalho que combina dados do Microsoft 365 com compreensão contextual para que os agentes possam raciocinar sobre o trabalho e tomar medidas. Para obter uma descrição geral completa das capacidades do IQ de Trabalho, veja Descrição geral do QI de Trabalho.

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 seguinte guia 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 Um assistente de IA 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.

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 remoto para expor o contexto de trabalho do Microsoft 365 como ferramentas para assistentes de IA em execução em ambientes de programador.

Local MCP

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

▶ Veja-o em ação na Demonstração Interativa

▶ Veja-o em ação na Demonstração Interativa

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 de aplicação não é suportada.
  • As permissões do Microsoft 365, as etiquetas de confidencialidade e as políticas de conformidade são impostas automaticamente.

Caminho a seguir para o novo desenvolvimento

O IQ de Trabalho é a base recomendada para novas aplicações com tecnologia de IA e agente nos dados do Microsoft 365. Crie um novo desenvolvimento nas APIs de IQ de Trabalho para tirar partido de protocolos unificados, governação integrada e investimento contínuo.

Requisitos de licenciamento

Paga pela utilização da API de QI de Trabalho através de um modelo baseado na utilização que utiliza Créditos Copilot. Para obter mais informações, veja Compreender a faturação baseada na utilização e a gestão de custos dos Créditos Copilot.

Conteúdo relacionado

  • Last updated on