Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'endpoint di messaggistica dell'agente è quello dove invii messaggi di notifica agentici al tuo agente.
Eliminare endpoint di messaggistica degli agenti
Usa il comando a365 cleanup blueprint --endpoint-only per eliminare l'entrata la registrazione dell'endpoint di messaggistica dell'agente. Questo comando non influisce sul codice dell'agente né sull'endpoint distribuito. Rimuove solo la registrazione tramite Teams Graph (piattaforma MCP).
a365 cleanup blueprint --endpoint-only
Configurare l'endpoint di messaggistica in a365.config.json
Prima di impostare l'endpoint di messaggistica, specificarlo nel file di configurazione a365.config.json. Questo file contiene la configurazione principale per la distribuzione del tuo agente.
Aggiungi o aggiorna queste proprietà di configurazione dell'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 il tuo agente è già distribuito e non devi aggiornare la configurazione dell'ambiente. ImpostadeploymentProjectPathsu.solo se il codice dell'agente non si trova sulla tua macchina.
Proprietà di configurazione
| Proprietà | Descrizione | Obbligatoria | Predefinita | Esempio |
|---|---|---|---|---|
messagingEndpoint |
L'URL su 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 dell'endpoint
Il valore messagingEndpoint dipende dallo scenario di distribuzione:
Per distribuzioni di Azure:
- App Web di Azure:
https://your-app-name.azurewebsites.net/api/messages
Per le distribuzioni non-Azure:
- AWS:
https://your-api-gateway-url.amazonaws.com/api/messages - GCP:
https://your-cloud-run-url.run.app/api/messages - Altri provider di servizi cloud: il tuo URL endpoint personalizzato
Per i test locali con tunnel dev:
- URL del tunnel dev:
https://abc123xyz.devtunnels.ms:3978/api/messages
Importante
Il deploymentProjectPath indica dove l'interfaccia della riga di comando cerca i file di progetto e dove aggiorna la configurazione dell'ambiente, come i file .env.
Nota
Quando usi i tunnel dev per i test locali, aggiorna il messagingEndpoint in a365.config.json con l'URL del tunnel dev prima di eseguire il comando di configurazione. Per ulteriori informazioni, consulta test con tunnel dev.
Impostare l'endpoint di messaggistica degli agenti
Dopo aver aggiornato il file a365.config.json, usa questo comando per registrare l'endpoint per la messaggistica in modo che il servizio Agent 365 possa inviare notifiche al tuo agente. L'operazione --endpoint-only registra l'endpoint tramite Teams Graph (MCP Platform).
a365 setup blueprint --endpoint-only
Puoi anche passare direttamente l'URL con --messaging-endpoint, invece di modificare a365.config.json:
a365 setup blueprint --endpoint-only `
--messaging-endpoint https://your-app.azurewebsites.net/api/messages
Durante i test locali, puoi impostare questo endpoint su un endpoint tunnel dev prima di distribuire l'agente nel cloud. Per ulteriori informazioni, consulta test con tunnel dev.
Per aggiornare l'URL dell'endpoint esistente:
a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages
Distribuzione dell'endpoint
Se non hai già il tuo agente distribuito nel cloud, impara a distribuire l'agente su Azure.
Se hai già distribuito il tuo agente nel cloud, puoi impostare l'endpoint di messaggistica come illustrato in precedenza.
Scopri come impostare l'endpoint di messaggistica su altri cloud popolari: