IQ de Trabalho - Criar copilotConversation

Importante

As APIs na /beta versão estão sujeitas a alterações. A utilização destas APIs em aplicações de produção não é suportada.

A API de Chat do IQ de Trabalho permite-lhe criar e continuar conversações multiturno com Microsoft 365 Copilot, respeitando simultanemente os controlos de acesso definidos na organização. Utilize a API de Chat para integrar Microsoft 365 Copilot nas suas soluções de IA geradoras.

Esta documentação abrange a criação de conversações Copilot com a API de Chat. Saiba como continuar conversações síncronas ou conversações em fluxo com a API de Chat.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) WorkIQAgent.Ask Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST https://workiq.svc.cloud.microsoft/rest/beta/copilot/conversations

Cabeçalhos de solicitação

Nome Descrição
Authorization Bearer {token}. Obrigatório.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça um corpo JSON vazio.

Resposta

Se for bem-sucedida, esta ação devolve um 201 Created código de resposta e uma copilotConversation no corpo da resposta.

Exemplo

O exemplo seguinte mostra como criar uma conversação copilot através da API de Chat do IQ de Trabalho. Assim que a conversação for criada, o id no corpo da resposta é utilizado como um parâmetro de caminho para continuar a conversação, utilizando o ponto final síncrono ou o ponto final transmitido em fluxo.

Solicitação

O exemplo a seguir mostra a solicitação.

POST https://workiq.svc.cloud.microsoft/rest/beta/copilot/conversations
Content-Type: application/json

{}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0d110e7e-2b7e-4270-a899-fd2af6fde333",
  "createdDateTime": "2025-09-30T15:28:46.1560062Z",
  "displayName": "",
  "status": "active",
  "turnCount": 0
}

Conteúdo relacionado

  • Last updated on