Endpoint di messaggistica dell'agente

L'endpoint di messaggistica dell'agente è quello dove invii messaggi di notifica agentici al tuo agente.

Elimina l'endpoint di messaggistica dell'agente

Usare il comando a365 cleanup blueprint --endpoint-only per eliminare la registrazione dell'endpoint di messaggistica dell'agente. Questo comando non influisce sul codice dell'agente né sull'endpoint distribuito. Rimuove solo la voce di registrazione.

Per gli agenti M365 (Teams, Copilot), utilizza --m365 per cancellare l'endpoint tramite 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

Configura l'endpoint di messaggistica in a365.config.json

Prima di impostare l'endpoint di messaggistica, specificalo nel file a365.config.json di configurazione. Questo file contiene la configurazione principale per il deployment del tuo agente.

Aggiungi o aggiorna queste proprietà di configurazione degli endpoint di messaggistica:

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

  • messagingEndpoint: Specifica l'URL esatto dell'endpoint dove puoi inviare messaggi all'agente.

  • deploymentProjectPath: percorso della directory del progetto dell'agente. Questa proprietà non è rilevante se l'agente è già distribuito e non è necessario aggiornare la configurazione dell'ambiente. Imposta deploymentProjectPath su . solo se il codice dell'agente non si trova sulla tua macchina.

Proprietà di configurazione

Proprietà Descrizione Obbligatorio Predefinito Esempio
messagingEndpoint L'URL in cui il tuo agente riceve i messaggi Sì Nessuno https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Percorso della directory del progetto agente per gli aggiornamenti della configurazione No . ./my-agent o .

Opzioni di configurazione degli endpoint

Il messagingEndpoint valore dipende dal tuo scenario di schieramento:

Per le distribuzioni di Azure:

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

Per le distribuzioni non di Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Altri fornitori di servizi cloud: il tuo URL endpoint personalizzato

Per i test locali con Dev Tunnels:

  • URL del tunnel di sviluppo: https://abc123xyz.devtunnels.ms:3978/api/messages

Importante

Specifica deploymentProjectPath dove la CLI cerca i file di progetto e dove aggiorna la configurazione dell'ambiente, come i .env file.

Annotazioni

Quando si usano i Dev Tunnels per i test locali, aggiornare messagingEndpoint con l'URL del Dev Tunnel prima di eseguire il comando di configurazione. Per maggiori informazioni, vedi test con Dev Tunnel.

Imposta l'endpoint di messaggistica dell'agente

Dopo aver aggiornato il a365.config.json file, usare questo comando per registrare l'endpoint di messaggistica in modo che il servizio Agent 365 possa inviare notifiche all'agente.

Per gli agenti M365 (Teams, Copilot), passare --m365 per registrarsi tramite 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

Durante i test locali, puoi impostare questo endpoint come un Dev Tunnel prima di distribuire l'agente nel cloud. Per maggiori informazioni, vedi test con Dev Tunnel.

Per aggiornare un URL dell'endpoint esistente:

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

Distribuzione dell'endpoint

Se l'agente non è già stato distribuito nel cloud, informazioni su come distribuire l'agente in Azure.

Se hai già il tuo agente distribuito nel cloud, puoi impostare l'endpoint di messaggistica come mostrato prima.

Scopri come impostare l'endpoint di messaggistica su altri cloud popolari:

  • Last updated on