Koncový bod pro zasílání zpráv agenta

Koncový bod po zasílání zpráv agenta je místo, kam posíláte agentní notifikační zprávy svému agentovi.

Odstranění koncového bodu pro zasílání zpráv agenta

Použijte příkaz a365 cleanup blueprint --endpoint-only k vymazání registrace koncového bodu pro zasílání zpráv agenta. Tento příkaz neovlivňuje váš kód agenta ani nasazený koncový bod. Odstraní pouze registrační záznam prostřednictvím Teams Graph (MCP Platform).

a365 cleanup blueprint --endpoint-only

Konfigurujte koncový bod pro zasílání zpráv v a365.config.json

Před nastavením koncového bodu pro zasílání zpráv ho specifikujte ve svém konfiguračním souboru a365.config.json. Tento soubor obsahuje základní konfiguraci pro nasazení vašeho agenta.

Přidejte nebo aktualizujte tyto konfigurační vlastnosti koncového bodu pro zasílání zpráv:

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

  • messagingEndpoint: Zadejte přesnou URL koncového bodu, na kterou můžete agentovi zasílat zprávy.

  • deploymentProjectPath: Cesta k adresáři vašeho projektu agenta. Tato vlastnost není relevantní, pokud je váš agent již nasazen a nepotřebujete aktualizovat konfiguraci prostředí. Nastavte deploymentProjectPath na . pouze tehdy, pokud kód agenta není na vašem počítači.

Vlastnosti konfigurace

Vlastnost Popis Požaduje se Výchozí Příklad
messagingEndpoint URL, kde váš agent přijímá zprávy Ano Žádná https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Cesta k adresáři projektu agenta pro aktualizace konfigurace Ne . ./my-agent nebo .

Možnosti konfigurace koncového bodu

Hodnota messagingEndpoint závisí na vašem scénáři nasazení:

Pro nasazení v Azure:

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

Pro nasazení mimo Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Ostatní cloudoví poskytovatelé: Vaše vlastní URL koncového bodu

Pro lokální testování s vývojovými tunely:

  • URL vývojového tunelu: https://abc123xyz.devtunnels.ms:3978/api/messages

Důležité

deploymentProjectPath určuje, kde CLI hledá soubory projektu a kde aktualizuje konfiguraci prostředí, například soubory .env.

Poznámka:

Při používání vývojových tunelů pro lokální testování aktualizujte messagingEndpoint v a365.config.json tak, aby obsahoval URL vývojového tunelu, před spuštěním příkazu setup. Pro více informací viz testování s vývojovými tunely.

Nastavení koncového bodu pro zasílání zpráv agentovi

Po aktualizaci souboru a365.config.json použijte tento příkaz k registraci koncového bodu pro zasílání zpráv, aby služba Agent 365 mohla posílat oznámení vašemu agentovi. Operace --endpoint-only registruje koncový bod prostřednictvím Teams Graph (MCP Platform).

a365 setup blueprint --endpoint-only

URL můžete také předat přímo pomocí --messaging-endpoint, místo úpravy a365.config.json:

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

Během lokálního testování můžete tento koncový bod nastavit na koncový bod vývojového tunelu před nasazením agenta do cloudu. Pro více informací viz testování s vývojovými tunely.

Pro aktualizaci existujícího URL koncového bodu:

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

Nasazení koncového bodu

Pokud ještě nemáte agenta nasazeného v cloudu, naučte se, jak nasadit agenta do Azure.

Pokud již máte svého agenta nasazeného v cloudu, můžete nastavit koncový bod pro zasílání zpráv, jak bylo uvedeno dříve.

Naučte se, jak nastavit koncový bod pro zasílání zpráv na některých dalších populárních cloudech:

  • Last updated on