Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Importante
- L’API Insights IA de réunion est disponible sous la version bêta dans Microsoft Graph. Pour plus d’informations, consultez Gestion des versions, prise en charge et stratégies de changement cassant pour Microsoft Graph.
- L’API Insights IA de réunion fait partie de l’espace de noms de l’API Microsoft 365 Copilot. Les insights ne peuvent être récupérés que pour le compte d’un utilisateur Microsoft 365 Copilot sous licence. Pour plus d’informations, consultez Conditions de licence pour l’API Meeting Insights.
L’API Meeting Insights IA vous permet d’accéder par programme aux insights structurés générés par l’IA à partir de réunions Microsoft Teams transcrites. Ces insights sont les suivants :
- Résumés complets des conversations
- Éléments d’action extraits de la discussion
- Énoncés dans lesquels les participants sont directement mentionnés
L’API vous permet de fournir des expériences de réunion intelligentes, telles que la présentation de points clés ou la génération de suivis, sans avoir à créer ou à gérer votre propre infrastructure IA. Les insights sont générés une fois la réunion terminée et sont accessibles via les points de terminaison Microsoft API Graph.
Remarque
L’API de Insights IA de réunion fournit des insights uniquement pour les réunions privées planifiées.
Cas d'utilisation
Voici quelques cas d’utilisation pour extraire des insights générés par l’IA à l’aide de l’API Meeting Insights IA :
Cas d’utilisation | Scénario | Intégration | Impact |
---|---|---|---|
Générer automatiquement des résumés de réunion pour les mises à jour CRM | Une équipe commerciale organise régulièrement des réunions client sur Teams. Après chaque appel, ils doivent consigner les résumés et les suivis des réunions dans leur CRM. | Après chaque réunion, vous pouvez demander à un service principal d’écouter les événements de fin de réunion et d’utiliser les API Microsoft Graph pour extraire des insights post-réunion. Le service extrait des résumés et des éléments d’action, puis les mappe à des champs spécifiques dans les enregistrements CRM de l’entreprise. Si vous le souhaitez, l’intégration peut inclure un message Teams carte confirmant la mise à jour. | - Permet aux représentants commerciaux de gagner du temps en éliminant l’entrée manuelle. - Garantit une capture cohérente des détails clés dans toutes les interactions client. |
Capturer les connaissances post-réunion dans une application de gestion de projet | Les équipes produit et d’ingénierie organisent des réunions régulières pour prendre des décisions en matière de conception et de fonctionnalité. Les membres de l’équipe oublient souvent de documenter ce qui a été discuté et convenu. | Vous pouvez utiliser un bot ou un travail en arrière-plan pour interroger l’API Graph des réunions terminées appartenant aux prospects de produit. L’API extrait des insights et utilise le traitement en langage naturel (NLP) pour les classifier, comme les décisions, les tâches ou les éléments à risque. Ces classifications sont converties en tâches ou notes dans Azure DevOps, Jira ou Notion, et affectées aux parties prenantes appropriées à l’aide d’identités d’utilisateur Graph. | - Empêche la perte d’informations. - Comble automatiquement l’écart entre la conversation et le suivi des tâches. - Favorise l’alignement et la responsabilité. |
Générer des réunions d’information de la direction pour les réunions stratégiques | Les dirigeants participent à plusieurs réunions de haut niveau dans des fonctions telles que les finances, les opérations ou les révisions du conseil d’administration. Ils ont besoin de résumés rapides et fiables pour rester à jour et prendre des mesures. | Vous pouvez créer un assistant numérique pour appeler le API Graph après la fin des réunions de direction désignées pour récupérer des insights, hiérarchiser les décisions clés et les blocages, et les mettre en forme dans un briefing quotidien concis carte. Cette carte est publiée dans la conversation Teams de l’exécutif ou envoyée sous forme de résumé par e-mail du matin. L’intégration peut éventuellement mettre en surbrillance des thèmes récurrents à l’aide de mot clé clustering entre les réunions. | - Améliore l’attention de la direction et la rapidité de décision. - Réduit la dépendance à la prise de notes et aux suivis manuels. Permet une reconnaissance interfonctionnale plus rapide. |
Configuration requise
Vous devez activer la transcription ou l’enregistrement de la réunion pour laquelle les insights doivent être générés. Vous pouvez également définir une réunion pour qu’elle soit automatiquement transcrite ou enregistrée automatiquement à l’aide de l’API update onlineMeeting ou directement via les options de réunion.
L’API de Insights IA de réunion fonctionne uniquement avec des autorisations déléguées et nécessite donc qu’un jeton d’un utilisateur connecté soit passé dans l’appel. L’utilisateur connecté doit disposer d’une licence Microsoft 365 Copilot et d’un accès au fichier de transcription de la réunion.
Extraire des insights de réunion
Pour extraire les insights d’une réunion particulière, procédez comme suit :
Si vous n’avez pas l’identificateur de réunion (
id
), appelez l’API de réunion en ligne avec laJoinWebUrl
propriété pour récupérer leid
. Pour plus d’informations, consultez Récupérer une réunion en ligne par JoinWebUrl.Chaque événement de transcription de la réunion crée un objet d’insight IA associé. Utilisez l’API List Insights IA pour extraire tous les objets d’insights IA liés à la réunion et utilisez les métadonnées incluses dans la réponse pour sélectionner l’objet d’insight IA approprié pour votre scénario. Voici un exemple de demande et de réponse :
Demande
GET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights
Réponse
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" } ] }
Propriété Description id
Identificateur unique pour l’objet d’insight IA généré. callId
Identificateur unique de l’appel au cours duquel cet insight est généré. contentCorrelationId
Identificateur unique qui met en corrélation la transcription de la réunion à partir de laquelle l’objet d’insight IA est généré. createdDateTime
Date et heure de création de la transcription correspondante. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours en temps universel coordonné (UTC). endDateTime
Date et heure de fin de la transcription correspondante. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Chaque objet d’insight IA fournit des notes de réunion détaillées, des éléments d’action et des mentions spécifiques aux participants, qui sont accessibles en appelant GET Insights IA API pour un ID d’objet insight spécifique. Voici un exemple de demande et de réponse :
Demande
GET /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights/{aiInsightId}
Réponse
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." }, ] } }
Propriété Description meetingNotes
Contient des notes détaillées de la discussion de réunion générée par Microsoft Teams Copilot. Les notes incluent un titre, un résumé et des sous-points détaillés de la discussion. actionItems
Contient les éléments d’action générés à partir de la conversation de réunion. Les éléments d’action incluent un résumé de l’élément d’action et du propriétaire affecté. viewpoint.mentionEvents
Contient des informations spécifiques aux participants de la conversation, y compris les mentions avec les horodatages de la réunion lorsqu’un utilisateur est mentionné, l’orateur et les détails de l’énoncé.
Limitations
- Les insights générés par l’IA ne sont disponibles qu’après la fin d’une réunion. L’API ne prend pas en charge l’accès aux notes en direct pendant une réunion.
- La disponibilité des insights générés par l’IA peut prendre jusqu’à quatre heures après la fin de l’appel.
- Les autorisations au niveau de l’application ne sont pas prises en charge.
Exemple de code
Exemple de nom | Description | Node.js |
---|---|---|
Bot d’insights IA de réunion | Cet exemple d’application récupère les résumés de réunion, les éléments d’action et les mentions à l’aide de l’API Meeting Insights IA et les affiche dans une boîte de dialogue. | View |