Partager via

Point de 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 agentiques destinés à 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 supprime uniquement l'entrée d'enregistrement de ce point d'accès 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 : indiquez à l’interface CLI si vous souhaitez déployer 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. Définissez deploymentProjectPath sur . 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 Que le CLI soit déployé sur Azure (true) ou que vous hébergiez par vous-même (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 :

For Azure deployments (needDeployment: true) :

  • application web Azure : 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 effectuez un déploiement sur Azure, définissez needDeployment sur 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.
  • Le deploymentProjectPath détermine l'endroit où la CLI recherche les fichiers de projet et où elle actualise la configuration de l'environnement, notamment les fichiers .env.

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 test avec les tunnels de développement.

Définir le point de terminaison de messagerie de l'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 test avec les tunnels de développement.

a365 setup blueprint --endpoint-only

Déploiement du point de terminaison

Si votre agent n'est pas déjà déployé dans le cloud, learn comment déployer l'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