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 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 (pré-visualizaçã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:

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.

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

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 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)

▶ 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

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.

Conteúdo relacionado

• Início rápido do A2A do IQ de Trabalho (pré-visualização)
• Descrição geral da API REST do IQ de Trabalho (pré-visualização)
• CLI do Microsoft Work IQ (pré-visualização)
• Termos de Utilização das APIs de IQ do Microsoft Work (pré-visualização)
• Experimente as APIs na Demonstração Interativa (pré-visualização)