שימוש בסוכן

שימוש ב-Agent Platform SDK

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

Framework	תיאור
ערכת פיתוח לסוכנים (ADK)	הקורס מבוסס על השיטות המומלצות של Google למפתחים שיוצרים אפליקציות מבוססות-AI או לצוותים שצריכים ליצור במהירות אב טיפוס ולפרוס פתרונות מבוססי-סוכנים.
‫Agent2Agent (גרסת טרום-השקה)	‫פרוטוקול Agent2Agent‏ (A2A) הוא תקן פתוח שנועד לאפשר תקשורת חלקה ושיתוף פעולה בין סוכני AI.
LangChain	קל יותר להשתמש בו בתרחישים בסיסיים, כי יש לו הגדרות מוגדרות מראש והפשטות.
LangGraph	גישה מבוססת-תרשים להגדרת תהליכי עבודה, עם יכולות מתקדמות של "האדם שבתהליך" והרצה אחורה/הפעלה מחדש.
AG2 (לשעבר AutoGen)	‫AG2 מספקת מסגרת שיחה מרובת סוכנים כהפשטה ברמה גבוהה ליצירת תהליכי עבודה של LLM.
‫LlamaIndex (גרסת טרום-השקה (Preview))	צינור עיבוד הנתונים של השאילתות ב-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/LOCATION/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?"}]
  }
}'

‫Run agent (streaming)

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. במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.
   

   מעבר אל Agent Platform Deployments

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

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

3. לוחצים על הכרטיסייה Playground.

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

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

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

   • אירוע: תרשים של ממשקי ה-API שהופעלו ופרטי האירועים במהלך השיחות עם הנציג.

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

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

תמיכה ב-Playground

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

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

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

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