เพิ่มเครื่องมือให้กับตัวแทน Azure AI
Tip
ดูแท็บ ข้อความและรูปภาพ สําหรับรายละเอียดเพิ่มเติม!
ใน Microsoft Agent Framework เครื่องมือช่วยให้ตัวแทน AI ของคุณใช้ API และบริการที่มีอยู่เพื่อทํางานที่ไม่สามารถทําได้ด้วยตัวเอง เครื่องมือทํางานผ่านการเรียกฟังก์ชัน ทําให้ AI สามารถร้องขอและใช้ฟังก์ชันเฉพาะได้โดยอัตโนมัติ เฟรมเวิร์กกําหนดเส้นทางคําขอไปยังฟังก์ชันที่เหมาะสมในโค้ดเบสของคุณ และส่งคืนผลลัพธ์กลับไปยังโมเดลภาษาขนาดใหญ่ (LLM) เพื่อให้สามารถสร้างการตอบสนองขั้นสุดท้ายได้
ในการเปิดใช้งานการเรียกใช้ฟังก์ชันอัตโนมัติ เครื่องมือจําเป็นต้องให้รายละเอียดที่อธิบายวิธีการทํางาน อินพุต เอาต์พุต และวัตถุประสงค์ของฟังก์ชันควรอธิบายในลักษณะที่ AI สามารถเข้าใจได้ มิฉะนั้น AI จะไม่สามารถเรียกใช้ฟังก์ชันได้อย่างถูกต้อง
วิธีใช้เครื่องมือกับ Microsoft Foundry Agent
Microsoft Agent Framework รองรับทั้งเครื่องมือฟังก์ชันแบบกําหนดเองและเครื่องมือในตัวที่พร้อมใช้งานทันที
เครื่องมือในตัว
Microsoft Foundry Agents มาพร้อมกับเครื่องมือในตัวหลายอย่างที่คุณสามารถใช้ได้ทันที:
- Code Interpreter - รันโค้ด Python สําหรับการคํานวณ การวิเคราะห์ข้อมูล และอื่นๆ
- การค้นหาไฟล์ - ค้นหาและวิเคราะห์เอกสาร
- การค้นหาเว็บ - ดึงข้อมูลจากอินเทอร์เน็ต
เครื่องมือเหล่านี้จะพร้อมใช้งานโดยอัตโนมัติและไม่ต้องตั้งค่าเพิ่มเติม
เครื่องมือฟังก์ชันแบบกําหนดเอง
เมื่อสร้างเครื่องมือแบบกําหนดเองสําหรับตัวแทน Microsoft Foundry คุณต้องเข้าใจแนวคิดหลักหลายประการ:
ใช้เครื่องมือตกแต่ง
สร้างเครื่องมือฟังก์ชันแบบกําหนดเองโดยกําหนดฟังก์ชัน Python และตกแต่งด้วย
@toolตัวตกแต่งจาก Microsoft Agent Framework ตัวตกแต่งนี้จะลงทะเบียนฟังก์ชันของคุณเป็นเครื่องมือที่ AI สามารถเรียกได้@toolตัวตกแต่งมีพารามิเตอร์สําหรับระบุชื่อและคําอธิบายสําหรับเครื่องมือของคุณ รวมถึงapproval_modeการระบุว่าการเรียกใช้เครื่องมือต้องได้รับการอนุมัติหรือไม่คําจํากัดความของฟังก์ชันและคําอธิบายประกอบ
สร้างเครื่องมือของคุณโดยกําหนดฟังก์ชัน Python ปกติด้วยคําอธิบายประกอบประเภทที่เหมาะสม ใช้
AnnotatedและFieldจาก Pydantic เพื่อให้คําอธิบายโดยละเอียดที่ช่วยให้ AI เข้าใจวัตถุประสงค์ของฟังก์ชันและวิธีใช้พารามิเตอร์ ยิ่งคําอธิบายประกอบของคุณมีคําอธิบายมากเท่าใด AI ก็จะยิ่งเข้าใจได้ดีขึ้นว่าจะเรียกฟังก์ชันของคุณเมื่อใดและอย่างไรการเพิ่มเครื่องมือให้กับเจ้าหน้าที่ของคุณ
ส่งฟังก์ชันที่กําหนดเองของคุณไปยัง ChatAgent ระหว่างการสร้าง
toolsโดยใช้พารามิเตอร์ คุณสามารถเพิ่มฟังก์ชันเดียวหรือรายการหลายฟังก์ชัน เฟรมเวิร์กจะลงทะเบียนฟังก์ชันเหล่านี้โดยอัตโนมัติและทําให้ AI สามารถเรียกใช้ได้การเรียกใช้เครื่องมือผ่านการสนทนา
เมื่อลงทะเบียนเครื่องมือของคุณกับตัวแทนแล้ว คุณไม่จําเป็นต้องเรียกใช้ด้วยตนเอง ให้ถามคําถามกับตัวแทนหรือมอบหมายงานที่ต้องใช้ฟังก์ชันการทํางานของเครื่องมือของคุณโดยธรรมชาติ AI จะกําหนดโดยอัตโนมัติว่าเมื่อใดควรเรียกใช้เครื่องมือของคุณตามบริบทการสนทนาและคําอธิบายเครื่องมือที่คุณให้ไว้
เครื่องมือและการประสานงานที่หลากหลาย
คุณสามารถเพิ่มเครื่องมือหลายอย่างให้กับตัวแทนคนเดียว และ AI จะเลือกเครื่องมือที่จะใช้โดยอัตโนมัติตามคําขอของผู้ใช้ เฟรมเวิร์กจะจัดการการประสานงาน โดยเรียกฟังก์ชันที่เหมาะสม และรวมผลลัพธ์เพื่อให้การตอบสนองที่ครอบคลุม
แนวทางปฏิบัติที่ดีที่สุดสําหรับการพัฒนาเครื่องมือ
- คําอธิบายที่ชัดเจน: เขียนคําอธิบายที่ชัดเจนและละเอียดสําหรับฟังก์ชันและพารามิเตอร์ของคุณเพื่อช่วยให้ AI เข้าใจวัตถุประสงค์
- คําอธิบายประกอบประเภท: ใช้คําแนะนําประเภท Python ที่เหมาะสมเพื่อระบุประเภทอินพุตและเอาต์พุตที่คาดหวัง
- การจัดการข้อผิดพลาด: ใช้การจัดการข้อผิดพลาดที่เหมาะสมในฟังก์ชันเครื่องมือของคุณเพื่อจัดการกับอินพุตที่ไม่คาดคิดอย่างราบรื่น
- ส่งคืนข้อมูลที่มีความหมาย: ตรวจสอบให้แน่ใจว่าฟังก์ชันของคุณส่งคืนข้อมูลที่ AI สามารถใช้ในการตอบสนองได้อย่างมีประสิทธิภาพ
- โฟกัสฟังก์ชัน: ออกแบบเครื่องมือแต่ละอย่างเพื่อจัดการงานเฉพาะแทนที่จะพยายามทําหลายสิ่งมากเกินไปในฟังก์ชันเดียว
เมื่อปฏิบัติตามแนวคิดเหล่านี้ คุณจะสามารถขยาย Microsoft Foundry Agent ของคุณด้วยเครื่องมือทั้งในตัวและแบบกําหนดเอง ซึ่งช่วยให้สามารถโต้ตอบกับ API และทํางานขั้นสูงได้ วิธีนี้ทําให้ AI ของคุณมีประสิทธิภาพมากขึ้นและสามารถจัดการแอปพลิเคชันในโลกแห่งความเป็นจริงได้อย่างมีประสิทธิภาพ