Concepts de développement

Pour intégrer votre application de flux de travail à Dragon Copilot, vous devez comprendre le flux de travail et l’architecture globale. Vous allez créer un point de terminaison d’API qui s’intègre au flux de travail Dragon Copilot. Votre application peut implémenter deux flux différents :

1. Flux itératif : ce flux est utilisé lorsque votre application doit interagir avec les tours audio de la rencontre. Par exemple, votre application peut analyser les données audio et fournir des commentaires ou des suggestions en temps réel en fonction de la conversation.

2. Flux de fin de rencontre : ce flux est utilisé lorsque votre application traite l’intégralité de la rencontre une fois qu’elle s’est terminée. Par exemple, votre application peut analyser la transcription complète et la note clinique pour générer un résumé ou identifier des insights clés.

Le diagramme suivant illustre le flux de données itératif avec authentification :

Schéma de point de terminaison d’API

Les applications de flux de travail doivent implémenter un point de terminaison d’API RESTful qui respecte le schéma de l’API d’extensibilité Dragon Copilot. Ce schéma définit les points de terminaison, les formats de demande/réponse requis et les opérations prises en charge. Le schéma est fourni en tant que fichier YAML OpenAPI (Swagger). Les éléments clés sont les suivants :

• POST /v1/process : point d’entrée principal pour que Dragon Copilot appelle votre application. La charge utile de la demande inclut les données de session, le contexte utilisateur et les données de rencontre demandées.
• Réponse : votre application doit retourner une réponse qui inclut le résultat de l’application, comme une charge utile de carte adaptative, des actions et toutes les données supplémentaires requises par le client.

Le schéma complet est disponible dans le fichier de schéma de l’API d’extensibilité Dragon dans le référentiel d’exemples officiel.

Exemple de demande et de réponse

Lorsque Dragon Copilot appelle votre application de flux de travail, il envoie une charge utile JSON qui inclut les informations de session, le contexte utilisateur et toutes les données cliniques pertinentes. Votre application traite cette demande et retourne une réponse structurée.

Des exemples sont disponibles dans la documentation sur les exemples de demandes et de réponses.

Authentification

La communication sécurisée entre Dragon Copilot et votre application de flux de travail est essentielle. L’authentification est gérée à l’aide d’un principal de service Entra et OAuth 2.0. Le processus implique les éléments suivants :

• Inscrivez votre application en tant qu’application dans Entra ID.
• Configurez des propriétés supplémentaires sur l’application.
• Implémentez la validation de jeton dans votre application pour garantir que seules les requêtes autorisées provenant de Dragon Copilot sont acceptées.
• Inscrivez le fournisseur de ressources Microsoft.HealthPlatform dans votre abonnement Azure pour activer l’intégration.

Pour obtenir des instructions détaillées, consultez la documentation sur la conception de l’authentification et de l’autorisation.

Réponse de carte adaptative

La réponse de votre application doit inclure une charge utile de carte adaptative, qui définit la manière dont la sortie est affichée dans l’application Dragon Copilot. Les cartes adaptatives sont un framework d’interface utilisateur basé sur JSON qui vous permet de présenter des informations et des actions dans un format cohérent et interactif. Pour plus d’informations et de détails sur le schéma, consultez la documentation des cartes adaptatives.

Flux de développement

Le diagramme ci-dessous illustre les étapes fondamentales du parcours de développement pour créer et intégrer une application de flux de travail Dragon Copilot. Les étapes principales, du développement local au test d’intégration, sont les suivantes :

1. Développement et test locaux : configurez votre environnement de développement et créez votre extension. Utilisez le code d’exemple dans le référentiel d’exemples et le schéma d’API pour garantir la compatibilité avec Dragon Copilot. Utilisez un client REST pour tester votre API.

2. Configuration de l’authentification : configurez l’authentification pour la plateforme Dragon Copilot afin de communiquer en toute sécurité avec votre extension. Cela implique la configuration des principaux de service et l’inscription des fournisseurs de ressources Azure requis.

3. Test d’intégration ou test en bac à sable : testez votre application localement à l’aide d’outils comme les tunnels dev pour simuler une URL publique.

4. Déploiement : déployez votre extension dans un environnement du centre d’administration Dragon. Cette étape rend votre extension disponible pour que vos utilisateurs Dragon Copilot puissent l’utiliser.

Glossaire

• Client : l’application Dragon Copilot où les utilisateurs interagissent avec votre extension. Il peut s’agir des applications de bureau, web ou mobiles Microsoft Dragon Copilot. Il peut également s’agir d’un DMI qui incorpore l’interface utilisateur web de Dragon Copilot.
• Tunnel de développement : service qui crée une URL publique pour votre application exécutée localement. Utilisez-le pour les tests d’intégration locaux. Pour plus d’informations, consultez : Documentation sur les tunnels dev.
• Centre d’administration Dragon : plateforme d’administration d’une organisation Dragon Copilot. Il permet aux administrateurs Dragon de provisionner des produits Dragon, de configurer des environnements et de paramétrer les réglages Dragon Copilot pour leurs utilisateurs. Les administrateurs peuvent également installer des applications et des agents IA pour leurs environnements. Pour plus d’informations, consultez : Documentation du centre d’administration Dragon.
• Application locale : votre application s’exécutant sur votre ordinateur local.
• Plateforme : gère toutes les opérations liées à Dragon Copilot, y compris la conservation d’un enregistrement de votre manifeste et l’appel de votre point de terminaison selon le contrat.
• Application de production : votre application déployée, qui dispose d’une URL publique.

---

Vous êtes prêt à développer ? Démarrer