ปลายทางการส่งข้อความของเอเจนต์

ปลายทางการส่งข้อความของเอเจนต์คือจุดที่คุณส่งข้อความแจ้งเตือนของเอเจนต์ไปยังเอเจนต์ของคุณ

ลบปลายทางการส่งข้อความของเอเจนต์

ใช้ a365 cleanup blueprint --endpoint-only คำสั่ง เพื่อลบการลงทะเบียนปลายทางการส่งข้อความของเอเจนต์ คำสั่งนี้ไม่มีผลต่อรหัสเอเจนต์ของคุณหรือปลายทางที่ปรับใช้ โดยจะลบรายการลงทะเบียนผ่าน Teams Graph (แพลตฟอร์ม MCP) เท่านั้น

a365 cleanup blueprint --endpoint-only

กำหนดค่าปลายทางการส่งข้อความใน a365.config.json

ก่อนตั้งค่าปลายทางการส่งข้อความ ให้ระบุในไฟล์การกำหนดค่า a365.config.json ของคุณ ไฟล์นี้ประกอบด้วยการตั้งค่าหลักสำหรับการปรับใช้เอเจนต์ของคุณ

เพิ่มหรือปรับปรุงพารามิเตอร์การกำหนดค่าปลายทางการส่งข้อความเหล่านี้:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}
  • messagingEndpoint: ระบุ URL ปลายทางที่แน่นอนซึ่งคุณสามารถส่งข้อความไปยังเอเจนต์ได้

  • deploymentProjectPath: เส้นทางไปยังไดเรกทอรีโครงการเอเจนต์ของคุณ คุณสมบัตินี้ไม่เกี่ยวข้องหากเอเจนต์ของคุณถูกปรับใช้แล้ว และคุณไม่จำเป็นต้องอัปเดตการกำหนดค่าสภาพแวดล้อม ตั้งค่า deploymentProjectPath เป็น . เฉพาะเมื่อโค้ดของเอเจนต์ไม่ได้อยู่บนเครื่องของคุณ

คุณสมบัติการกำหนดค่า

คุณสมบัติ รายละเอียด ต้องมี ค่าเริ่มต้น ตัวอย่าง
messagingEndpoint URL ที่เอเจนต์ของคุณรับข้อความ ใช่ ไม่มี https://your-app.azurewebsites.net/api/messages
deploymentProjectPath เส้นทางไปยังไดเรกทอรีโครงการเอเจนต์ของคุณสำหรับการอัปเดตการกำหนดค่า ไม่ . ./my-agent หรือ .

ตัวเลือกการกำหนดค่าปลายทาง

ค่าของ messagingEndpoint ขึ้นอยู่กับสถานการณ์การปรับใช้ของคุณ:

สำหรับการปรับใช้ Azure:

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

สำหรับการปรับใช้ที่ไม่ใช่ Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • ผู้ให้บริการระบบคลาวด์รายอื่น: URL ปลายทางที่กำหนดเองของคุณ

สำหรับการทดสอบในเครื่องด้วย Dev Tunnels:

  • URL ของ Dev Tunnel: https://abc123xyz.devtunnels.ms:3978/api/messages

สำคัญ

deploymentProjectPath ระบุตำแหน่งที่ CLI ค้นหาไฟล์โครงการและตำแหน่งที่อัปเดตการกำหนดค่าสภาพแวดล้อม เช่น ไฟล์ .env

หมายเหตุ

เมื่อใช้ Dev Tunnels สำหรับการทดสอบในเครื่อง ให้อัปเดต messagingEndpoint ใน a365.config.json ด้วย URL ของ Dev Tunnel ของคุณก่อนเรียกใช้คำสั่ง setup สำหรับข้อมูลเพิ่มเติม โปรดดู การทดสอบด้วย Dev Tunnels

ตั้งค่าจุดสิ้นสุดการส่งข้อความของเอเจนต์

หลังจากอัปเดตไฟล์ a365.config.json ของคุณแล้ว ให้ใช้คำสั่งนี้เพื่อจดทะเบียนปลายทางการส่งข้อความ เพื่อให้บริการ Agent 365 สามารถส่งการแจ้งเตือนไปยังเอเจนต์ของคุณได้ การดำเนินการ --endpoint-only จะลงทะเบียนปลายทางผ่าน Teams Graph (แพลตฟอร์ม MCP)

a365 setup blueprint --endpoint-only

คุณยังสามารถส่ง URL ได้โดยตรงด้วย --messaging-endpoint แทนการแก้ไข a365.config.json:

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

ในระหว่างการทดสอบภายในเครื่อง คุณสามารถตั้งค่าปลายทางนี้เป็นปลายทาง Dev Tunnel ก่อนที่จะปรับใช้เอเจนต์ไปยังระบบคลาวด์ สำหรับข้อมูลเพิ่มเติม โปรดดู การทดสอบด้วย Dev Tunnels

การอัปเดต URL ปลายทางที่มีอยู่:

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

การปรับใช้ปลายทาง

หากคุณยังไม่ได้ปรับใช้เอเจนต์ของคุณไปยังระบบคลาวด์ เรียนรู้วิธีปรับใช้เอเจนต์ไปยัง Azure

หากคุณได้ปรับใช้เอเจนต์ของคุณบนคลาวด์แล้ว คุณสามารถตั้งค่าปลายทางการส่งข้อความได้ตามที่แสดงไว้ก่อนหน้านี้

เรียนรู้วิธีตั้งค่าปลายทางการส่งข้อความบนคลาวด์ยอดนิยมอื่น ๆ: