Criar copilotConversation

Importante

As APIs sob a /beta versão estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.

A API do Microsoft 365 Copilot Chat permite que você crie e continue conversas de vários turnos com o Microsoft 365 Copilot, respeitando os controles de acesso definidos dentro da organização. Use a API de Chat para integrar o Microsoft 365 Copilot às suas soluções de IA generativa.

Esta documentação aborda a criação de conversas do Copilot usando a API de Chat. Saiba como continuar conversas síncronas ou conversas transmitidas com a API do Chat.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Sites.Read.All, Mail.Read, People. Read.All, OnlineMeetingTranscript.Read.All, Chat. Read, ChannelMessage.Read.All, ExternalItem.Read.All* Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

* Você precisa de todas essas permissões do Microsoft Graph para chamar com êxito a API do Microsoft 365 Copilot Chat.

Solicitação HTTP

POST https://graph.microsoft.com/beta/copilot/conversations

Cabeçalhos de solicitação

Nome Descrição
Authorization Bearer {token}. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça um corpo JSON vazio.

Resposta

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

Exemplo

O exemplo a seguir mostra como criar uma conversa do Copilot por meio da API do Microsoft 365 Copilot Chat. Depois que a conversa é criada, o id no corpo da resposta é usado como um parâmetro de caminho para continuar a conversa, usando o endpoint síncrono ou o endpoint transmitido.

Solicitação

O exemplo a seguir mostra a solicitação.

POST https://graph.microsoft.com/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

  • Última atualização a