แชร์ผ่าน

ทำการร้องขอทาง HTTP

  • บทความ

สำคัญ

ความสามารถและคุณลักษณะต่างๆ ของ Power Virtual Agents เป็น ส่วนหนึ่งของ Microsoft Copilot Studio แล้ว ภายหลังการลงทุนที่สำคัญใน Generative AI และการรวมที่ได้รับการปรับปรุงใน Microsoft Copilot

บทความและภาพหน้าจอบางรายการอาจอ้างถึง Power Virtual Agents ในขณะที่เราอัปเดตคู่มือและเนื้อหาการฝึกอบรม

ใน Copilot Studio คุณสามารถขยายความสามารถของ Copilot ได้โดยการเรียก REST API ภายนอกโดยใช้โหนด การร้องขอทาง HTTP สิ่งนี้มีประโยชน์เมื่อคุณต้องการดึงข้อมูลจากระบบภายนอกหรือจัดการข้อมูลบนระบบนั้น

ข้อกำหนดเบื้องต้น

ใช้โหนดการร้องขอทาง HTTP

  1. เลือก เพิ่มโหนด (+) เปิดเมนูย่อย ขั้นสูง จากนั้นเลือก ส่งการร้องขอทาง HTTP

    ภาพหน้าจอของตัวเลือกส่งการร้องขอทาง HTTPในเมนูขั้นสูง

  2. ในช่อง URL ให้ป้อน URL สำหรับตำแหน่งข้อมูล API ที่คุณต้องการเรียกใช้

  3. เลือก วิธีการ คำขอที่เหมาะสมจากรายการแบบหล่นลง รองรับวิธีการ GET, POST, PATCH, PUT และ DELETE

    ภาพหน้าจอของ URL API ที่เสร็จสมบูรณ์และรายการแบบหล่นลงวิธีการ

  4. ใต้ ส่วนหัวและเนื้อหา บนโหนด ให้คลิกปุ่ม แก้ไข ซึ่งจะเปิดบานหน้าต่าง คุณสมบัติการร้องขอทาง HTTP

  5. คุณสามารถเลือกเพิ่มส่วนหัวอย่างน้อย 1 รายการในการร้องขอทาง HTTP ได้ คลิกปุ่ม เพิ่ม เพื่อเพิ่มคีย์และค่าของส่วนหัวแต่ละรายการ

    ภาพหน้าจอของรายการคู่ค่าคีย์ส่วนหัวสำหรับโหนด HTTP

  6. ตามค่าเริ่มต้น จะไม่มีการส่งเนื้อหาในส่วนเนื้อหาของการร้องขอทาง HTTP แต่คุณ ระบุเนื้อหาที่จะส่งบนเนื้อหา

  7. บนโหนด ให้เลือก ชนิดข้อมูลการตอบสนอง จากตัวเลือกที่มี

    คุณสามารถจัดเตรียมตัวอย่างการตอบสนอง JSON (ซึ่งโดยปกติแล้วคุณจะพบได้ในคู่มือสำหรับ API ที่คุณเรียกใช้) ซึ่งจะสร้างตัวแปร Power FX ที่พิมพ์อย่างเข้มงวด ช่วยให้คุณสามารถนำไปใช้ที่อื่นในพื้นที่การเขียนของคุณด้วยการสนับสนุน Intellisense ในตัวแก้ไข Power FX เมื่อต้องการทำเช่นนี้ ให้เลือก จากข้อมูลตัวอย่าง แล้วคลิก รับสคีมาจากตัวอย่าง JSON โดยวางคำตอบตัวอย่างของคุณลงในโปรแกรมแก้ไขที่แสดงและเลือก ยืนยัน

    ภาพหน้าจอของรับสคีมาจากตัวแก้ไข JSON ตัวอย่าง

  8. ภายใต้ บันทึกการตอบกลับเป็น เลือกตำแหน่งที่คุณต้องการจัดเก็บการตอบกลับการร้องขอทาง HTTP ไม่ว่าจะเป็นการสร้างตัวแปรใหม่หรือการเลือกตัวแปรที่มีอยู่

ส่งเนื้อหาในเนื้อหาการร้องขอทาง HTTP

  1. ใต้ ส่วนหัวและเนื้อหา บนโหนด ให้คลิกปุ่ม แก้ไข ซึ่งจะเปิดบานหน้าต่าง คุณสมบัติการร้องขอทาง HTTP

  2. ภายใต้ เนื้แหา ให้เลือกชนิดเนื้อหาที่เหมาะสม โดยค่าเริ่มต้นนี้จะถูกตั้งค่าเป็น ไม่มีเนื้อหา โดยที่ไม่ควรมีเนื้อหาอยู่ในเนื้อหาคำขอ ซึ่งมักใช้กับคำขอ GET หากต้องการเพิ่มเนื้อหาลงในเนื้อหา ให้เลือกจากตัวเลือกที่มีอยู่

    ภาพหน้าจอของรายการแบบหล่นลงตัวเลือกเนื้อหา

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

      คุณยังสามารถป้อนระบุเนื้อหา JSON ของคุณโดยใช้ Power FX ซึ่งช่วยให้คุณสามารถรวมค่าไดนามิกและตัวแปรอ้างอิงได้ เมื่อต้องการทำเช่นนี้ ให้เลือก แก้ไข JSON ให้เลือก สูตร จากนั้นป้อนออบเจ็กต์ Power FX (JSON ใด ๆ ที่มีอยู่ที่ป้อนไว้แล้วจะถูกแปลงเป็นออบเจ็กต์ Power FX สำหรับคุณ) ซึ่งจะถูกแปลงเป็น JSON เมื่อมีการร้องขอ HTTP

      ภาพหน้าจอของเนื้อหา JSON ที่เลือกสำหรับชนิดเนื้อหาของเนื้อหา

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

      ภาพหน้าจอของเนื้อหา RAW ที่เลือกสำหรับชนิดเนื้อหาของเนื้อหา

การจัดการและการหมดเวลาของข้อผิดพลาด

โหนด การร้องขอทาง HTTP มีหลายตัวเลือกสำหรับการจัดการสถานการณ์ที่การร้องขอทาง HTTP อาจล้มเหลวหรือส่งคืนข้อผิดพลาด

ตามค่าเริ่มต้น คุณลักษณะนี้จะ "ทำให้เกิดข้อผิดพลาด" ซึ่งหมายความว่าเมื่อการร้องขอทาง HTTP ส่งคืนข้อผิดพลาดหรือล้มเหลวในการดำเนินการ Copilot จะหยุดการดำเนินการและทริกเกอร์หัวข้อของระบบ ข้อผิดพลาด โดยแสดงข้อความแสดงข้อผิดพลาด

อย่างไรก็ตาม คุณสามารถกำหนดค่าการจัดการข้อผิดพลาดเพื่อไม่ให้ทริกเกอร์หัวข้อระบบ ข้อผิดพลาด และเติมรหัสสถานะ HTTP และเนื้อหาการตอบสนองข้อผิดพลาดใดๆ ลงในตัวแปรที่คุณระบุแทน เพื่อให้คุณสามารถซักถามตัวแปรเหล่านี้ได้ตามต้องการ และเพื่อให้หัวข้อทำงานต่อไป สิ่งนี้มีประโยชน์ในสถานการณ์ที่คุณต้องการให้ Copilot ดำเนินการต่อไปแม้ว่าการร้องขอทาง HTTP เฉพาะจะล้มเหลวก็ตาม

เพื่อกำหนดค่าลักษณะการทำงานการจัดการข้อผิดพลาด

  1. ใต้ ส่วนหัวและเนื้อหา บนโหนด ให้คลิกปุ่ม แก้ไข ซึ่งจะเปิดบานหน้าต่าง คุณสมบัติการร้องขอทาง HTTP

  2. เลือกลักษณะการทำงานที่ต้องการจากรายการแบบหล่นลง การจัดการข้อผิดพลาด

  3. หากคุณเลือก ดำเนินการต่อเมื่อมีข้อผิดพลาด ให้กำหนดค่า รหัสสถานะ และตัวแปร เนื้อหาการตอบสนองข้อผิดพลาด ไม่ว่าจะสร้างตัวแปรใหม่หรือเลือกตัวแปรที่มีอยู่จากตัวเลือก

    ภาพหน้าจอของการจัดการข้อผิดพลาดที่กำหนดค่าให้ดำเนินการต่อเมื่อมีข้อผิดพลาดพร้อมตัวแปรที่ระบุสำหรับรหัสสถานะและเนื้อหาการตอบสนองข้อผิดพลาด

ในตัวอย่างโค้ดนี้ หากการร้องขอทาง HTTP ล้มเหลว Copilot จะจัดเก็บโค้ดสถานะ HTTP ไว้ในตัวแปร Topic.StatusCode และเนื้อหาการตอบในตัวแปร Topic.ErrorResponse จากนั้น Copilot จะดำเนินการต่อไปยังขั้นตอนต่อไปในหัวข้อ

ชนิดตัวแปร การตอบสนองข้อผิดพลาด จะเป็น ใดๆ คุณสามารถใช้ โหนดแยกวิเคราะห์ค่า เพื่อแปลงสิ่งนี้เป็นเรกคอร์ด Power Fx

แผงคุณสมบัติยังมีคุณสมบัติ Request timeout ซึ่งยอมรับค่าในหน่วยมิลลิวินาที ค่าเริ่มต้นคือ 30 วินาที แต่คุณสามารถเปลี่ยนค่านี้ได้หากจำเป็น