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

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

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

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

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

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

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

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

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

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

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

המסוף

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

    כניסה ל-Agent Registry

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

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

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

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

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

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

gcloud

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

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

gcloud 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 לקריאה בלבד בצד הצרכן, שסוכנים ומנהלי תזמור יכולים לגלות ולהשתמש בו.

Terraform

כדי לרשום נקודת קצה חיצונית, מגדירים את המשאב google_agent_registry_service באמצעות הבלוק endpoint_spec:

resource "google_agent_registry_service" "endpoint" {
  location     = "REGION"
  service_id   = "ENDPOINT_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external REST API registered using Terraform."

  interfaces {
    url              = "ENDPOINT_URL"
    protocol_binding = "PROTOCOL"
  }

  endpoint_spec {
    type = "NO_SPEC"
  }
}

output "endpoint_resource_name" {
  description = "The generated read-only Endpoint resource name."
  value       = google_agent_registry_service.endpoint.registry_resource
}

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

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