שימוש בסוכן

שימוש ב-Agent Platform SDK

כשמשתמשים ב-Agent Platform SDK, הקוד לשאילתת סוכן זהה בין אם הוא פועל באופן מקומי או בפריסה מרחוק. מכיוון שקבוצת הפעולות הנתמכות משתנה בין מסגרות, אנחנו מספקים הוראות שימוש בתבניות ספציפיות למסגרות:

Framework	תיאור
Agent Development Kit	הכלי מבוסס על שיטות מומלצות פנימיות של Google למפתחים שיוצרים אפליקציות AI או לצוותים שצריכים ליצור אב טיפוס ולפרוס במהירות פתרונות חזקים שמבוססים על סוכנים.
‫Agent2Agent (תצוגה מקדימה)	‫Agent2Agent (A2A) protocol הוא תקן פתוח שנועד לאפשר תקשורת ושיתוף פעולה חלקים בין סוכני AI.
LangChain	קל יותר להשתמש בו בתרחישי שימוש בסיסיים בגלל ההגדרות המוגדרות מראש וההפשטות שלו.
LangGraph	גישה מבוססת-גרפים להגדרת תהליכי עבודה, עם יכולות מתקדמות של מעורבות אנושית ושל הרצה אחורה/הרצה קדימה.
‫AG2 (לשעבר AutoGen)	‫AG2 מספק מסגרת לשיחות בין סוכנים כהפשטה ברמה גבוהה ליצירת תהליכי עבודה של LLM.
‫LlamaIndex (תצוגה מקדימה)	צינור השאילתות של LlamaIndex מציע ממשק ברמה גבוהה ליצירת תהליכי עבודה של Retrieval-Augmented Generation (יצירה משולבת-אחזור, RAG).
בהתאמה אישית	סוכנים שפותחו ונפרסו בלי להשתמש בתבנית ספציפית למסגרת.
חוזה בזמן ריצה	מפרט HTTP API לסוכנים מותאמים אישית שמבוססים על מאגרי תגים.

שימוש בסוכנים שמופעלים ב-localhost

אם אתם מפעילים סוכנים דרך שרת API שמקשיב לבקשות ב-http://localhost:PORT_NUMBER, אתם צריכים לשלוח בקשות אל

http://localhost:PORT_NUMBER/API_PATH

איפה

• ‫PORT_NUMBER הוא מספר היציאה שהשרת מקשיב לה (לדוגמה, 8080)
• ‫API_PATH הוא הנתיב של נקודת קצה ל-API המתאימה (לדוגמה, run או run_sse)

שימוש בסוכנים שנפרסו דרך ה-API הבסיסי שלהם

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

https://LOCATION-aiplatform.googleapis.com/reasoningEngines/v1/projects/PROJECT_NUMBER/locations/<var>LOCATION</var>/reasoningEngines/RESOURCE_ID/api/API_PATH

איפה

• ‫PROJECT_ID הוא מזהה הפרויקט שבו פרסתם את הסוכן. Google Cloud
• ‫LOCATION הוא האזור שבו הסוכן נפרס
• ‫RESOURCE_ID הוא המזהה של הסוכן שנפרס כמשאב reasoningEngine
• ‫API_PATH הוא הנתיב של נקודת קצה ל-API המתאימה

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

לדוגמה, אם פרסתם את שרת ה-API של ADK מתוך Dockerfile או תמונת קונטיינר, תוכלו להפעיל את נקודות הקצה של ה-API באופן הבא:

הפעלת סוכן (תשובה אחת)

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the capital of France?"}]
  }
}'

הפעלת סוכן (סטרימינג)

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run_sse -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the weather in New York?"}]
  },
  "streaming": true
}'

שימוש בסוכנים שנפרסו במסוף Google Cloud

אם פרסתם סוכנים שפיתחתם באמצעות ערכה לפיתוח סוכנים (ADK), אתם יכולים להשתמש בGoogle Cloud מסוף כדי לתקשר עם הסוכן:

1. נכנסים לדף Agent Platform Deployments במסוף Google Cloud .
   

   מעבר אל Agent Platform Deployments

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

2. לוחצים על השם של זמן הריצה.

3. לוחצים על הכרטיסייה סביבת ניסויים.

4. אתם יכולים להקליד הודעה כדי ליצור אינטראקציה עם הנציג, וללחוץ על סשן חדש כדי להתחיל סשן חדש עם הנציג.

5. אם הפעלתם מעקב באמצעות OpenTelemetry, תוכלו לראות פרטים על התנהגות הסוכן במהלך האינטראקציות:

   • מעקב: מעקב אחר השיחות עם הסוכן.

   • אירוע: תרשים של ממשקי API שהופעלו ופרטי אירועים במהלך השיחות עם הסוכן.

   • מדינה: מידע על המדינה שבה נמצא הנציג במהלך השיחות.

   • סשנים: רשימת סשנים שמשויכים לסוכן. מידע נוסף זמין במאמר בנושא ניהול באמצעות מסוף Google Cloud או קריאות API

תמיכה ב-Playground

אפשר להשתמש במסגרות הבאות כדי לנסות את הסוכן:

Framework	צ'אט עם נציג תמיכה	צפייה בסשנים
ערכה לפיתוח סוכנים (ADK)	נתמך	יש תמיכה הסוכן צריך להטמיע את Agent Platform Sessions כדי לשמור על נתונים.
‫Agent2Agent (A2A)	יש תמיכה הסוכן צריך להטמיע את Agent Platform Sessions כדי לשמור על נתונים.	יש תמיכה הסוכן נדרש להשתמש בסשנים של Agent Platform, והוא צריך לשלוח את הערך user_id כחלק מאובייקט ההקשר. דוגמה לאופן העברת הערך user_id כחלק מה-agent executor מופיעה במחברת Get started with A2A.

המאמרים הבאים

• הערכת סוכן
• ניהול סוכנים שנפרסו
• פנייה לתמיכה