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

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

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

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

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

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

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

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

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

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

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

המסוף

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

    כניסה ל-Agent Registry

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

  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, מאגר הסוכנים יוצר באופן אוטומטי משאב 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.