Condividi tramite

Endpoint di messaggistica Agent

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 a365 cleanup blueprint --endpoint-only comando 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",
  "needDeployment": false,
  "deploymentProjectPath": "."
}

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

  • needDeployment: Indica alla CLI se vuoi che distribuisca il tuo codice su un'app web Azure.

  • deploymentProjectPath: Distribuisci il codice del tuo agente nel cloud. Questa proprietà non è rilevante se il tuo agente è già stato implementato e non devi riutilizzarlo. Imposta deploymentProjectPath 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
needDeployment Se la CLI debba essere distribuita su Azure (true) o se stai self-hosting (false) NO true false per AWS/GCP/Dev Tunnel
deploymentProjectPath Percorso verso la directory del progetto agente per aggiornamenti di distribuzione e configurazione NO . ./my-agent o .

Opzioni di configurazione degli endpoint

Il messagingEndpoint valore dipende dal tuo scenario di schieramento:

Per implementazioni Azure (needDeployment: true):

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

Per implementazioni non-Azure (needDeployment: false):

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

Per i test locali con i Dev Tunnel (needDeployment: false):

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

Importante

  • Quando distribuisci su Azure, imposta needDeployment a true. La CLI gestisce automaticamente il deployment.
  • Per AWS, GCP o Dev Tunnel, imposta needDeployment su false per indicare che stai gestendo il deployment separatamente.
  • Specifica deploymentProjectPath dove la CLI cerca i file di progetto e dove aggiorna la configurazione dell'ambiente, come i .env file.

Annotazioni

Quando usi i Dev Tunnels per i test locali, aggiorna l'input messagingEndpointa365.config.json con l'URL del Dev Tunnel e imposta needDeployment su false prima di eseguire il comando di configurazione. Per maggiori informazioni, vedi test con Dev Tunnel.

Imposta l'endpoint di messaggistica 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 non hai già il tuo agente distribuito nel cloud, impara a distribuire l'agente su 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