Partager via

Terminaison de messagerie d’agent

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

Le point de terminaison de messagerie de l’agent est celui où vous envoyez des messages de notification agent à votre agent.

Supprimer le point de terminaison de messagerie de l’agent

Utilisez la a365 cleanup blueprint --endpoint-only commande pour supprimer l’entrée du point de terminaison de messagerie de l’agent. Cette commande n’affecte pas le code de votre agent ni le point de terminaison déployé. Cela ne supprime que l’entrée d’enregistrement de ce point de terminaison pour votre agent.

a365 cleanup blueprint --endpoint-only

Configurez le point de terminaison de messagerie dans a365.config.json

Avant de définir le point de terminaison de messagerie, spécifie-le dans votre a365.config.json fichier de configuration. Ce fichier contient la configuration de base pour le déploiement de votre agent.

Ajoutez ou mettez à jour ces propriétés de configuration du point de terminaison de messagerie :

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "needDeployment": false,
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Spécifiez l’URL exacte du point de terminaison où vous pouvez envoyer des messages à l’agent.

  • needDeployment: Indiquer à la CLI si vous souhaitez qu’elle déploie votre code sur une application web Azure.

  • deploymentProjectPath: Déploie le code de ton agent dans le cloud. Cette propriété n’est pas pertinente si votre agent est déjà déployé et que vous n’avez pas besoin de le déployer à nouveau. Réglez deploymentProjectPath uniquement . si le code de l’agent n’est pas localisé sur votre machine.

Propriétés de configuration

Propriété Descriptif Obligatoire Par défaut Example
messagingEndpoint L’URL où votre agent reçoit les messages Oui Aucun https://your-app.azurewebsites.net/api/messages
needDeployment Si la CLI doit-elle être déployée sur Azure (true) ou si vous êtes en auto-hébergement (false) Non true false pour les tunnels AWS/GCP/Dev
deploymentProjectPath Chemin vers le répertoire de votre projet agent pour le déploiement et les mises à jour de configuration Non . ./my-agent ou .

Options de configuration du point de terminaison

La messagingEndpoint valeur dépend de votre scénario de déploiement :

Pour les déploiements Azure (needDeployment: true) :

  • Azure Web App : https://your-app-name.azurewebsites.net/api/messages

Pour les déploiements non-Azure (needDeployment: false) :

  • AWS : https://your-api-gateway-url.amazonaws.com/api/messages
  • BPC : https://your-cloud-run-url.run.app/api/messages
  • Autres fournisseurs cloud : Votre URL de terminaison personnalisée

Pour les tests locaux avec des tunnels de développement (needDeployment: false) :

  • URL du tunnel de développement : https://abc123xyz.devtunnels.ms:3978/api/messages

Important

  • Lorsque vous déployez sur Azure, définissez needDeployment à true. La CLI gère automatiquement le déploiement.
  • Pour AWS, GCP ou Dev Tunnels, réglez needDeployment sur false pour indiquer que vous gérez le déploiement séparément.
  • Il spécifie deploymentProjectPath où la CLI recherche les fichiers de projet et où elle met à jour la configuration de l’environnement, comme les .env fichiers.

Note

Lorsque vous utilisez les Dev Tunnels pour des tests locaux, mettez à jour l’entrée messagingEndpointa365.config.json avec votre URL de Dev Tunnel et définissez needDeployment sur false avant d’exécuter la commande de configuration. Pour plus d’informations, voir tests avec les tunnels de développement.

Définir le point de terminaison de messagerie agent

Après avoir mis à jour votre a365.config.json fichier, utilisez cette commande pour enregistrer le point de terminaison de messagerie auprès du service Agent 365 afin qu’il puisse envoyer des notifications à votre agent.

Lors des tests locaux, vous pouvez définir ce point de terminaison comme un point de terminaison Dev Tunnel avant de déployer l’agent dans le cloud. Pour plus d’informations, voir tests avec les tunnels de développement.

a365 setup blueprint --endpoint-only

Déploiement du point de terminaison

Si vous n’avez pas déjà déployé votre agent dans le cloud, apprenez à déployer un agent sur Azure.

Si vous avez déjà déployé votre agent dans le cloud, vous pouvez définir le point de terminaison de messagerie comme indiqué précédemment.

Apprenez à définir le point de terminaison de messagerie sur d’autres clouds populaires :

  • Amazon Web Services
  • Google Cloud Platform
  • Last updated on