Obtenha resumos de reuniões gerados por IA com a API de Insights da IA de Reunião

A API Meeting Insights da IA permite que você acesse programaticamente insights estruturados gerados por IA de reuniões transcritas do Microsoft Teams. Esses insights incluem:

• Resumos de conversa abrangentes
• Itens de ação extraídos da discussão
• Enunciados em que os participantes são mencionados diretamente

A API permite que você forneça experiências de reunião inteligentes, como revelar os principais conclusões ou gerar acompanhamentos, sem a necessidade de criar ou manter sua própria infraestrutura de IA. Os insights são gerados após a conclusão da reunião e podem ser acessados por meio dos pontos de extremidade da API do Graph.

Casos de uso

Aqui estão alguns casos de uso para buscar insights gerados por IA usando a API de Insights da IA de reunião:

Pré-requisitos

• Você deve ativar a transcrição ou a gravação para que a reunião gere insights. Como alternativa, você pode definir uma reunião para transcrever automaticamente ou gravar automaticamente programaticamente usando a API atualizar onlineMeeting ou diretamente por meio das opções de reunião.

Requisitos de licença para equipes que atendem às APIs de insights de IA

Esta seção descreve os requisitos de licença para o Teams que atendem às APIs de insights de IA. Para acessar essas APIs, os usuários devem ter uma licença do Microsoft 365 Copilot. Modelos de pagamento ou modo de avaliação não são aplicáveis a essas APIs; Eles podem ser usados por qualquer aplicativo para usuários que possuem a licença necessária.

Buscar insights de reuniões

Para buscar os insights de uma reunião específica, siga estas etapas:

1. Se você não tiver o identificador da reunião (id), chame a API de reunião online com a JoinWebUrl propriedade para recuperar o idarquivo . Para obter mais informações, consulte recuperar uma reunião online por JoinWebUrl.

2. Cada evento de transcrição da reunião cria um objeto de insight de IA associado. Use a API List Insights da IA da IA para buscar todos os objetos de insight de IA relacionados à reunião e use os metadados incluídos na resposta para selecionar o objeto de insight de IA relevante para seu cenário. Aqui está um exemplo de solicitação e resposta:

Exemplo

Solicitação

O exemplo a seguir recupera todos os objetos de insight de IA para uma reunião online específica.

GET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights

Resposta

O exemplo a seguir mostra uma resposta com uma lista de objetos de insight de IA. As IDs no exemplo foram reduzidas para facilitar a leitura.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#copilot/users('22431...')/onlineMeetings('MSoyM...')/aiInsights",
  "@odata.count": 1,
  "value": [
    {
      "id": "VjEjI...",
      "callId": "97d0b...",
      "contentCorrelationId": "fb7aa...",
      "createdDateTime": "2025-12-08T05:41:31Z",
      "endDateTime": "2025-12-08T05:41:31Z"
    },
  ],
}

1. Cada objeto de insight de IA fornece notas detalhadas de reuniões, itens de ação e menções específicas do participante, que você pode acessar chamando a API GET Insights da IA para uma ID de objeto de insight específico. Aqui está um exemplo de solicitação e resposta:

Exemplo

Solicitação

O exemplo abaixo demonstra como recuperar um objeto de insight de IA.

GET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights/{aiInsightId}

Resposta

O exemplo a seguir mostra uma resposta com um resumo detalhado da reunião. As IDs no exemplo foram reduzidas para facilitar a leitura.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#copilot/users('22431...')/onlineMeetings('MSoyM...')/aiInsights/$entity",
  "id": "VjEjI...",
  "callId": "97d0b...",
  "contentCorrelationId": "fb7aa...",
  "createdDateTime": "2025-12-08T05:41:31Z",
  "endDateTime": "2025-12-08T05:41:31Z",
  "meetingNotes": [
    {
      "title": "Introducing Project Objectives and Key Stakeholders",
      "text": "The stakeholders present included representatives from each department involved in the project, ensuring alignment and clear communication channels from the start.",
      "subpoints": [
        {
          "title": "Discussion on action items",
          "text": "Action items were assigned to team members, and a follow-up meeting schedule was established."
        }
      ]
    }
  ],
  "actionItems": [
    {
      "title": "Project Timeline Finalization",
      "text": "Review and finalize the project timeline to ensure alignment with stakeholder expectations and resource availability.",
      "ownerDisplayName": "Bella Smith"
    },
  ],
  "viewpoint": {
    "mentionEvents": [
      {
        "eventDateTime": "2025-12-08T05:30:00Z",
        "transcriptUtterance": "We need to get approval from Sarah Johnson before proceeding with the budget allocation.",
        "speaker": {
            "application": null,
            "device": null,
            "user": {
                "@odata.type": "#microsoft.graph.teamworkUserIdentity",
                "id": "9a760...",
                "displayName": "John Smith",
                "userIdentityType": "aadUser",
                "tenantId": "d1aeb..."
            }
        },
      },
    ]
  }
}

Limitações

• Os insights gerados por IA só ficam disponíveis após o término de uma reunião. A API não oferece suporte ao acesso a anotações dinâmicas durante uma reunião.
• Os insights gerados por IA podem levar até quatro horas para estarem disponíveis após o término da chamada.

Exemplo de código

Confira também

• tipo de recurso callAiInsight
• Trabalhando com a API de comunicações na nuvem no Microsoft Graph