เพิ่มเวิร์กโฟลว์เป็นเครื่องมือให้กับเอเจนต์ (พรีวิว)

[บทความนี้เป็นเอกสารก่อนการนำออกใช้ และอาจเปลี่ยนแปลงได้]

หากเครื่องมือที่คุณต้องการไม่มีในรูปแบบ prebuilt, connector หรือ workflow คุณสามารถเพิ่มเครื่องมือแบบกําหนดเองได้โดยนําเข้า REST API จากข้อกําหนด OpenAPI

การเพิ่ม REST API เป็นเครื่องมือให้กับเอเจนต์ที่ขับเคลื่อนด้วยฮาร์เนส Customer Conversation คล้ายกับการเพิ่ม REST API ให้กับเอเจนต์ที่ขับเคลื่อนด้วยฮาร์เนสมาตรฐาน หากต้องการเรียนรู้เพิ่มเติม ดูที่ ขยายเอเจนต์ของคุณด้วยเครื่องมือจาก REST API (ตัวอย่าง)

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

• สําเนาของข้อกําหนด OpenAPI สําหรับ REST API ที่คุณต้องการเชื่อมต่อ
• ความรู้เกี่ยวกับประเภทของการรับรองความถูกต้องที่จําเป็นในการเชื่อมต่อกับ API และรายละเอียดการรับรองความถูกต้อง

เพิ่มเครื่องมือ REST API

1. ในแท็บ Build ให้เลือกการ์ดของเอเจนต์หลักเพื่อเปิดแผงกําหนดค่า หากคุณได้เพิ่มซับเอเจนต์ใด ๆ ให้เลือกการ์ดของซับเอเจนต์แทนเพื่อกําหนดค่าซับเอเจนต์นั้น

2. ในส่วน เครื่องมือ เลือก เพิ่มเครื่องมือ

3. ในหน้าต่างกล่องโต้ตอบ Add a tool ให้เลือกแท็บ REST API (หรือเลือก Add>REST API)

4. ในกล่องโต้ตอบ New REST API ให้ทําตามขั้นตอนวิซาร์ดดังนี้:

   1. อัปโหลดข้อกำหนด: นำเข้าข้อกำหนด OpenAPI (Swagger 2.0) หรือ OpenAPI 3.0 ลากและวางไฟล์ JSON หรือ YAML (สูงสุด 5 MB) หรือเลือก เรียกดู เพื่อเลือกไฟล์หนึ่งไฟล์

   2. รายละเอียดปลั๊กอิน API: ตั้งชื่อและคําอธิบายเครื่องมือของคุณเพื่อให้เอเจนต์ใช้ตัดสินใจว่าจะเรียกใช้เมื่อใด ตรวจสอบและแก้ไขฟิลด์ต่อไปนี้หากจําเป็นก่อนดําเนินการต่อ:

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

   3. การตรวจสอบสิทธิ์: เลือกวิธีที่เอเจนต์จะตรวจสอบตัวตนด้วย API นี้:

      • ไม่มี: ไม่จําเป็นต้องตรวจสอบสิทธิ์เพื่อเข้าถึง API
      • API key: agent ของคุณจะขอให้ผู้ใช้ป้อน API key ขณะรันไทม์ จากนั้นเชื่อมต่อกับ API โดยใช้คีย์นั้น คุณระบุ ป้ายกำกับ (ชื่อที่แสดงขณะเชื่อมต่อ), ชื่อพารามิเตอร์ (เช่น X-API-Key), และ ตำแหน่ง (ส่วนหัว หรือ คิวรี).
      • OAuth 2.0: ผู้ใช้ยืนยันตัวตนกับ API ผ่านผู้ให้บริการยืนยันตัวตนโดยไม่ต้องเปิดเผยข้อมูลรับรองแก่เอเจนต์ คุณระบุค่าต่างๆ เช่น Client ID, Client secret, Authorization URL, Token URL และ Refresh URL.

   4. เลือกเครื่องมือ: ภายใต้ เครื่องมือที่มีอยู่ ให้เลือกไอคอนบวกถัดจากแต่ละเครื่องมือที่รองรับ API (การรวมระหว่าง endpoint และ HTTP method เช่น get, put, post หรือ delete) ที่คุณต้องการเปิดเผยให้กับเอเจนต์ของคุณ ใช้กล่องค้นหาเพื่อค้นหาการดำเนินการที่ระบุ

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

   6. เลือกพารามิเตอร์เครื่องมือ: ตรวจสอบค่านําเข้าและส่งออกของคุณ และอัปเดตคําอธิบายตามความจําเป็น คุณสามารถอัปเดตคำอธิบายพารามิเตอร์ได้ แต่ไม่สามารถอัปเดตค่าพารามิเตอร์เองได้ หากมีคำอธิบายใดยังว่างอยู่ ให้กรอกให้เรียบร้อยก่อนดำเนินการต่อ ทำซ้ำขั้นตอน เลือกเครื่องมือ จนถึง เลือกพารามิเตอร์เครื่องมือ สำหรับแต่ละเครื่องมือที่คุณต้องการเพิ่มจาก API

   7. ทบทวน: ทบทวนชื่อเครื่องมือ คำอธิบาย ประเภทการยืนยันตัวตน และจำนวนเครื่องมือที่เลือกก่อนเผยแพร่

   8. เผยแพร่: เลือก เผยแพร่ เพื่อสร้างเครื่องมือและทําให้พร้อมใช้งานสําหรับตัวแทนของคุณ

เชื่อมต่อเครื่องมือหลังจากเผยแพร่

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

1. เลือกเครื่องมือที่เผยแพร่แล้วเพื่อเพิ่มลงในเอเจนต์
2. ในกล่องโต้ตอบ เชื่อมต่อกับชื่อเครื่องมือ ให้เลือก เลือกการเชื่อมต่อ จากนั้นเลือกการเชื่อมต่อที่มีอยู่ หรือสร้างใหม่:
   1. เลือก + การเชื่อมต่อใหม่
   2. ในกล่องโต้ตอบ Connect totool name ให้ป้อน ชื่อที่แสดง สําหรับการเชื่อมต่อได้ตามต้องการ ชื่อนี้จะปรากฏในรายการการเชื่อมต่อ
   3. เลือก สร้าง
3. เลือก เพิ่มและกำหนดค่า เพื่อเพิ่มเครื่องมือลงในเอเจนต์ให้เสร็จสมบูรณ์

ข้อมูลที่เกี่ยวข้อง

• ภาพรวมเครื่องมือสําหรับเจ้าหน้าที่
• เครื่องมือที่มีให้สําหรับเจ้าหน้าที่ (การสนทนากับลูกค้า)
• เพิ่มเครื่องมือให้กับเอเจนต์ (การสนทนากับลูกค้า)
• จัดการและลบเครื่องมือในเอเจนต์ (การสนทนากับลูกค้า)