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.
Importante
Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.
L'endpoint di messaggistica dell'agente è quello dove invii messaggi di notifica agentici al tuo agente.
Elimina l'endpoint di messaggistica dell'agente
Usa il comando a365 cleanup blueprint --endpoint-only per eliminare l'entrata dell'endpoint del messaggio agente. Questo comando non influisce sul codice dell'agente né sull'endpoint distribuito. Cancella solo la registrazione di questo endpoint per il tuo agente.
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. ImpostadeploymentProjectPathsu.solo se il codice dell'agente non si trova sulla tua macchina.
Proprietà di configurazione
| Proprietà | Description | Obbligatorio | Predefinito | Example |
|---|---|---|---|---|
messagingEndpoint |
L'URL in cui il tuo agente riceve i messaggi | Yes | None | https://your-app.azurewebsites.net/api/messages |
deploymentProjectPath |
Percorso della directory del progetto agente per gli aggiornamenti della configurazione | NO | . |
./my-agent oppure . |
Opzioni di configurazione degli endpoint
Il messagingEndpoint valore dipende dal tuo scenario di schieramento:
Per le distribuzioni di Azure:
- Azure App 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 file a365.config.json , usa questo comando per registrare l'endpoint di messaggistica presso il servizio Agent 365 in modo che possa inviare notifiche al tuo agente.
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.
a365 setup blueprint --endpoint-only
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: