Point de terminaison de messagerie d’agent

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 effacer l’inscription 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é. Elle supprime uniquement l’entrée d’inscription.

Pour les agents M365 (Teams, Copilot), passez --m365 pour effacer le point de terminaison via Teams Graph :

# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
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",
  "deploymentProjectPath": "."
}

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

  • deploymentProjectPath: chemin d’accès au répertoire de votre projet d’agent. Cette propriété n’est pas pertinente si votre agent est déjà déployé et que vous n’avez pas besoin de mettre à jour la configuration de l’environnement. 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é Description Obligatoire Default Example
messagingEndpoint L’URL où votre agent reçoit les messages Yes Aucun https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Chemin d’accès au répertoire de projet de votre agent pour les mises à jour de configuration No . ./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 :

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

Pour les déploiements autres qu’Azure :

  • 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 Dev Tunnels :

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

Important

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.

Remarque

Lorsque vous utilisez Dev Tunnels pour les tests locaux, mettez à jour l’entrée messagingEndpointa365.config.json avec votre URL Dev Tunnel avant d’exécuter la commande d’installation. 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 inscrire le point de terminaison de messagerie afin que le service Agent 365 puisse envoyer des notifications à votre agent.

Pour les agents M365 (Teams, Copilot), utilisez --m365 pour vous inscrire via le Teams Graph :

# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only

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.

Pour mettre à jour une URL de point de terminaison existante :

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages --m365

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