Point de terminaison de messagerie de l’assistant

Le point de terminaison de messagerie de l’assistant est celui où vous envoyez des messages de notification agentiques destinés à votre assistant.

Supprimer le point de terminaison de messagerie de l’assistant

Utilisez la a365 cleanup blueprint --endpoint-only commande pour supprimer l’inscription du point de terminaison de messagerie de l’assistant. Cette commande n’affecte pas le code de votre assistant ni le point de terminaison déployé. Seule l’entrée d’enregistrement est supprimée via Teams Graph (plateforme MCP).

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, renseignez-le dans votre fichier de configuration a365.config.json correspondant. Ce fichier contient la configuration de base pour le déploiement de votre assistant.

Ajoutez ou mettez à jour les propriétés de configuration suivantes pour le 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’assistant.

  • deploymentProjectPath : chemin d’accès au répertoire de votre projet d’assistant. Cette propriété n’est pas applicable si votre assistant 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 d’assistant ne se trouve pas sur votre machine.

Propriétés de configuration

Propriété Description Obligatoire Par défaut Exemple
messagingEndpoint L’URL où votre assistant reçoit des messages Oui Aucun https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Chemin vers le répertoire de votre projet d’assistant pour les mises à jour de configuration Non . ./my-agent ou .

Options de configuration du point de terminaison

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

Pour les déploiements Azure :

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

Pour les déploiements hors 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 point de terminaison personnalisée

Pour les tests locaux avec Dev Tunnels :

  • URL Dev Tunnel : https://abc123xyz.devtunnels.ms:3978/api/messages

Important

deploymentProjectPath indique où la CLI recherche les fichiers de projet et où elle met à jour la configuration de l’environnement, notamment les fichiers .env.

Note

Si vous utilisez Dev Tunnels pour les tests en local, mettez à jour la valeur de messagingEndpoint dans a365.config.json avec l’URL de votre tunnel Dev avant d’exécuter la commande de configuration. Pour plus d’informations, voir Test avec les tunnels dev.

Définir le point de terminaison de messagerie de l’assistant

Après avoir mis à jour votre fichier a365.config.json, utilisez cette commande pour enregistrer le point de terminaison de messagerie afin que le service Agent 365 puisse envoyer des notifications à votre assistant. L’opération --endpoint-only enregistre le point de terminaison via Teams Graph (plateforme MCP).

a365 setup blueprint --endpoint-only

Vous pouvez également fournir l’URL directement avec --messaging-endpoint, au lieu de modifier a365.config.json :

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Lors des tests en local, vous pouvez définir ce point de terminaison sur un point de terminaison Dev Tunnel avant de déployer l’assistant dans le cloud. Pour plus d’informations, voir Test avec les tunnels dev.

Pour mettre à jour l’URL d’un point de terminaison existant :

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

Déploiement du point de terminaison

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

Si vous avez déjà déployé votre assistant 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 :