הוספת כלים לסוכן Azure AI

הושלם

במסגרת הסוכן של Microsoft, כלים מאפשרים לסוכן הבינה המלאכותית שלך להשתמש בממשקי API ושירותים קיימים כדי לבצע משימות שהוא לא יכול היה לבצע בעצמו. הכלים פועלים באמצעות קריאת פונקציות, ומאפשרים לבינה מלאכותית לבקש ולהשתמש באופן אוטומטי בפונקציות ספציפיות. המסגרת מנתבת את הבקשה לפונקציה המתאימה בבסיס הקוד שלך ומחזירה את התוצאות בחזרה למודל השפה הגדול (LLM) כדי שהיא תוכל ליצור תגובה סופית.

כדי לאפשר קריאה אוטומטית לפונקציות, הכלים צריכים לספק פרטים המתארים את אופן פעולתם. יש לתאר את הקלט, הפלט והמטרה של הפונקציה בצורה שהבינה המלאכותית תוכל להבין, אחרת, הבינה המלאכותית לא יכולה לקרוא לפונקציה בצורה נכונה.

איך להשתמש בכלים עם Microsoft Foundry Agent

Microsoft Agent Framework תומך הן בכלי פונקציות מותאמים אישית והן בכלים מוכללים המוכנים לשימוש מוכן לשימוש.

כלים מובנים

Microsoft Foundry Agents מגיעים עם מספר כלים מובנים שניתן להשתמש בהם מיד:

  • Code Interpreter - מבצע קוד Python לחישובים, ניתוח נתונים ועוד
  • חיפוש קבצים - חיפוש ומנתח מסמכים
  • חיפוש באינטרנט - אחזור מידע מהאינטרנט

כלים אלה זמינים באופן אוטומטי ואינם דורשים התקנה נוספת.

כלי פונקציות מותאמים אישית

כשאתה יוצר כלים מותאמים אישית עבור Microsoft Foundry Agent שלך, עליך להבין כמה מושגים מרכזיים:

  1. השתמש במעצב הכלים

    צור כלי פונקציות מותאם אישית על ידי הגדרת פונקציית פייתון וקישוטה עם המעצב @tool מ-Microsoft Agent Framework. המעצב הזה רושם את הפונקציה שלך ככלי שה-AI יכול לקרוא לו. המעצב @tool כולל פרמטרים למתן שם ותיאור לכלי שלך, וכן approval_mode כדי לציין האם קריאות לכלים דורשות אישור.

  2. הגדרת פונקציה וביאורים

    צור את הכלי שלך על ידי הגדרת פונקציית Python רגילה עם הערות סוג מתאימות. השתמש Annotated ב- Pydantic Field כדי לספק תיאורים מפורטים שעוזרים לבינה המלאכותית להבין את מטרת הפונקציה וכיצד להשתמש בפרמטרים שלה. ככל שההערות שלך תיאוריות יותר, כך הבינה המלאכותית יכולה להבין טוב יותר מתי ואיך לקרוא לפונקציה שלך.

  3. הוספת כלים לסוכן שלך

    העבר את הפונקציות המותאמות אישית שלך ל-ChatAgent במהלך היצירה באמצעות הפרמטר tools . באפשרותך להוסיף פונקציה בודדת או רשימה של פונקציות מרובות. המסגרת רושמת אוטומטית את הפונקציות הללו והופכת אותן לזמינות עבור הבינה המלאכותית להתקשר.

  4. הפעלת כלי באמצעות שיחה

    לאחר שהכלים שלך נרשמים אצל הסוכן, אינך צריך להפעיל אותם באופן ידני. במקום זאת, שאל את הסוכן שאלות או תן לו משימות שבאופן טבעי ידרשו את הפונקציונליות של הכלי שלך. הבינה המלאכותית קובעת באופן אוטומטי מתי לקרוא לכלים שלך על סמך הקשר השיחה ותיאורי הכלים שסיפקת.

  5. כלים ותיאום מרובים

    אתה יכול להוסיף כלים מרובים לסוכן יחיד, והבינה המלאכותית בוחרת אוטומטית באיזה כלי להשתמש על סמך בקשת המשתמש. המסגרת מטפלת בתזמור, קוראת לפונקציות המתאימות ומשלבת את תוצאותיהן כדי לספק מענה מקיף.

שיטות עבודה מומלצות לפיתוח כלים

  • תיאורים ברורים: כתוב תיאורים ברורים ומפורטים עבור הפונקציות והפרמטרים שלך כדי לעזור לבינה המלאכותית להבין את מטרתם
  • הערות סוג: השתמש ברמזים מתאימים לסוג Python כדי לציין סוגי קלט ופלט צפויים
  • טיפול בשגיאות: יישם טיפול מתאים בשגיאות בפונקציות הכלי שלך כדי לטפל בצורה חיננית בקלט בלתי צפוי
  • החזר נתונים משמעותיים: ודא שהפונקציות שלך מחזירות נתונים שהבינה המלאכותית יכולה להשתמש בהם ביעילות בתגובותיה
  • שמור על פונקציות ממוקדות: עצב כל כלי כך שיטפל במשימה ספציפית במקום לנסות לעשות יותר מדי דברים בפונקציה אחת

על ידי יישום מושגים אלו, תוכל להרחיב את Microsoft Foundry Agent שלך עם כלים מובנים וכלים מותאמים אישית, מה שמאפשר לו לתקשר עם ממשקי API ולבצע משימות מתקדמות. גישה זו הופכת את הבינה המלאכותית שלך לחזקה יותר ומסוגלת לטפל ביישומים בעולם האמיתי ביעילות.