Compartilhar via

Obter resumos de reuniões geradas por IA com a API Insights da IA reunião

Importante

A API de Insights da IA de Reunião permite-lhe aceder programaticamente a informações estruturadas geradas por IA a partir de reuniões transcritas do Microsoft Teams. Estas informações incluem:

  • Resumos de conversação abrangentes
  • Itens de ação extraídos do debate
  • Expressões em que os participantes são mencionados diretamente

A API permite-lhe proporcionar experiências de reunião inteligentes, tais como tirar conclusões importantes ou gerar seguimentos, sem a necessidade de criar ou manter a sua própria infraestrutura de IA. As informações são geradas após a conclusão da reunião e são acessíveis através dos pontos finais do Microsoft API do Graph.

Observação

A API de Insights da IA de Reuniões fornece informações apenas para reuniões agendadas privadas.

Casos de uso

Seguem-se alguns casos de utilização para obter informações geradas por IA com a API Insights da IA reunião:

Caso de uso Cenário Integração Impacto
Resumos de reuniões geradas automaticamente para atualizações de CRM Uma equipa de vendas realiza reuniões regulares de clientes através do Teams. Após cada chamada, têm de registar resumos e seguimentos de reuniões no respetivo CRM. Após cada reunião, pode ter um serviço de back-end a escutar eventos de fim de reunião e a utilizar as APIs do Microsoft Graph para obter informações pós-reunião. O serviço extrai resumos e itens de ação e mapeia-os para campos específicos nos registos CRM da empresa. Opcionalmente, a integração pode incluir uma mensagem do Teams card confirmar a atualização. - Poupa tempo aos representantes de vendas ao eliminar a entrada manual.
- Garante uma captura consistente dos principais detalhes em todas as interações do cliente.
Capturar conhecimentos pós-reunião numa aplicação de gestão de projetos As equipas de produtos e engenharia realizam reuniões regulares para tomar decisões de design e funcionalidades. Os membros da equipa esquecem-se frequentemente de documentar o que foi discutido e acordado. Pode utilizar um bot ou uma tarefa em segundo plano para consultar o API do Graph para reuniões concluídas pertencentes a oportunidades potenciais de produtos. A API obtém informações e utiliza o processamento de linguagem natural (NLP) para classificá-las, como decisões, tarefas ou itens de risco. Estas classificações são convertidas em tarefas ou notas no Azure DevOps, Jira ou Noção e atribuídas aos intervenientes corretos com identidades de utilizador do Graph. - Impede a perda de informações.
- Liga automaticamente o intervalo entre a conversação e o controlo de tarefas.
- Promove o alinhamento e a responsabilidade.
Gerar briefings executivos para reuniões estratégicas Os executivos participam em várias reuniões de alto nível em funções como finanças, operações ou revisões do conselho de administração. Precisam de resumos rápidos e fiáveis para se manterem atualizados e agirem. Pode criar uma assistente digital para chamar o API do Graph após a conclusão das reuniões executivas designadas para obter informações, priorizar decisões-chave e bloqueadores e formatá-las num conciso briefing diário card. Este card é publicado na conversa do Teams do executivo ou enviado como um resumo de e-mail matinal. Opcionalmente, a integração pode realçar temas recorrentes através de palavra-chave clustering entre reuniões. - Melhora o foco executivo e a velocidade de decisão.
- Reduz a dependência da criação manual de notas e dos seguimentos. Permite uma maior deteção multifuncional.

Pré-requisitos

  • Tem de ativar a transcrição ou gravação da reunião para a qual as informações serão geradas. Em alternativa, pode definir uma reunião para efetuar a inscrição automática ou a gravação automática através de programação através da API update onlineMeeting ou diretamente através das opções de reunião.

  • A API de Insights da IA reunião só funciona com permissões delegadas e, por conseguinte, requer que um token de um utilizador com sessão iniciada seja transmitido na chamada. O utilizador com sessão iniciada tem de ter uma licença Microsoft 365 Copilot e acesso ao ficheiro de transcrição da reunião.

Obter informações da reunião

Para obter as informações de uma determinada reunião, siga estes passos:

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

  2. Cada evento de transcrição da reunião cria um objeto de informações de IA associado. Utilize a Lista Insights da IA API para obter todos os objetos de informações de IA relacionados com a reunião e utilize os metadados incluídos na resposta para selecionar o objeto de informações de IA relevante para o seu cenário. Eis um pedido de exemplo e uma resposta:

    Solicitação

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

    Response

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/users('000000000-0000-0000-0000-000000000000')/onlineMeetings('00000...')/aiInsights",
  "@odata.count": 1,
  "value": [
    {
      "id": "VjEj...",
      "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
      "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
      "createdDateTime": "2025-05-09T08:17:10.7261294Z",
      "endDateTime": "2025-05-09T08:17:10.7261294Z"
    }
  ]
}
    Propriedade Descrição
    id Um identificador exclusivo para o objeto de informações de IA gerado.
    callId Um identificador exclusivo para a chamada durante a qual estas informações são geradas.
    contentCorrelationId Um identificador exclusivo que correlaciona a transcrição da reunião a partir da qual o objeto de informações de IA é gerado.
    createdDateTime A data e hora em que a transcrição correspondente foi criada. O tipo de carimbo de data/hora representa as informações de data e hora com o formato ISO 8601 e está sempre na Hora Universal Coordenada (UTC).
    endDateTime A data e hora em que a transcrição correspondente termina. O tipo de carimbo de data/hora representa as informações de data e hora com o formato ISO 8601 e está sempre em UTC.

  3. Cada objeto de informações de IA fornece notas de reunião detalhadas, itens de ação e menções específicas dos participantes, que podem ser acedidas ao chamar a API GET Insights da IA para obter um ID de objeto de informações específico. Eis um pedido de exemplo e uma resposta:

    Solicitação

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

    Response

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/users('00000000-0000-0000-0000-000000000000')/onlineMeetings('000000...')/aiInsights/$entity",
  "id": "Z2HWbT...",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "createdDateTime": "2025-05-15T08:17:10.7261294Z",
  "endDateTime": "2025-05-15T08:32:10.7261294Z",
  "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": "Finalize Project Timeline",
      "text": "Review and finalize the project timeline to ensure alignment with stakeholder expectations and resource availability.",
      "ownerDisplayName": "Bella Smith",
    },
  ],
  "viewpoint": {
    "mentionEvents": [
      {
        "speaker": {
            "application": null,
            "device": null,
            "user": {
                "@odata.type": "#Microsoft.Teams.GraphSvc.teamworkUserIdentity",
                "id": "9a7608d3-53e4-4a92-804f-ef43f1e5f5b5",
                "displayName": "John Smith",
                "userIdentityType": "aadUser",
                "tenantId": "d1aeb56e-5a25-4d91-a4f6-0f5e6a50d887"
            }
        },
        "eventDateTime": "2024-05-21T09:00:00",
        "transcriptUtterance": "We need to get approval from Sarah Johnson before proceeding with the budget allocation."
      },
    ]
  }
}
    Propriedade Descrição
    meetingNotes Contém notas detalhadas do debate da reunião, conforme gerado pelo Microsoft Teams Copilot. As notas incluem um título, resumo e subpontos detalhados do debate.
    actionItems Contém os itens de ação gerados a partir da conversação da reunião. Os itens de ação incluem um resumo do item de ação e o proprietário atribuído.
    viewpoint.mentionEvents Contém informações específicas do participante da conversação, incluindo menções com os carimbos de data/hora na reunião quando um utilizador é mencionado, o orador e os detalhes da expressão.

Limitações

  • As informações geradas por IA só estão disponíveis após o fim de uma reunião. A API não suporta o acesso a notas em direto durante uma reunião.
  • As informações geradas por IA podem demorar até quatro horas a estarem disponíveis após o fim da chamada.
  • As permissões ao nível da aplicação não são suportadas.

Exemplo de código

Nome do exemplo Descrição Node.js
Bot de informações de IA da reunião Esta aplicação de exemplo obtém resumos de reuniões, itens de ação e menções através da API Insights da IA reunião e apresenta-os numa caixa de diálogo. Exibir

Confira também