רישום נקודות קצה

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

אזהרה: התכונה הזו לא נתמכת במיקומים מרובי-אזורים us ו-eu. חובה להשתמש באזור נתמך או במיקום global. מידע נוסף זמין במאמר מיקומים של רישום סוכנים.

לפני שמתחילים

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

כדי להשתמש בפקודות של ה-CLI של gcloud שמופיעות במסמך הזה, צריך לוודא שהגדרתם את סביבת ה-CLI של gcloud.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לרישום נקודות קצה במאגר סוכנים, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד עורך Agent Registry API (roles/agentregistry.editor) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

רישום נקודת קצה

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

המסוף

1. במסוף Google Cloud , עוברים אל Agent Registry:

   כניסה ל-Agent Registry

2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט שבו הגדרתם את Agent Registry. Google Cloud

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

4. לוחצים על הוספת נקודת קצה.

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

   אפשר גם ללחוץ על בדיקת החיבור בחלונית הזו כדי לבדוק את החיבור לכתובת ה-URL של היעד.

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

6. לוחצים על Save.

gcloud

יוצרים משאב Service עם endpoint-spec-type של no-spec.

רושמים את נקודת הקצה ומגדירים את פרטי החיבור של הממשק שלה:

gcloud alpha agent-registry services create ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

מחליפים את מה שכתוב בשדות הבאים:

• ‫ENDPOINT_NAME: השם שרוצים לתת לנקודת הקצה, למשל my-external-api.
• ‫PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור של המאגר.
• ‫DISPLAY_NAME: השם של נקודת הקצה שקריא לאנשים.
• ‫ENDPOINT_URL: כתובת היעד, לדוגמה, https://api.example.com/v1/data.
• ‫PROTOCOL: קישור הפרוטוקול לממשק. הערכים התקינים הם HTTP_JSON,‏ GRPC או JSONRPC.

אחרי שיוצרים את משאב Service, Agent Registry יוצר באופן אוטומטי משאב Endpoint לקריאה בלבד בצד הצרכן, שסוכנים ומתזמני תהליכים יכולים לגלות ולהשתמש בו.