שימוש ברישום אוטומטי

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

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

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

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

לפני שרושמים סוכנים, מגדירים את רישום הסוכנים. כדי לאמת את ההרשמה, צריך את מזהה הפרויקט.

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

רישום סוכנים מ-Agent Runtime

אם אתם מפתחים ופורסים סוכנים באמצעות Agent Runtime ב-Gemini Enterprise Agent Platform, הרישום ב-Agent Registry מתבצע באופן אוטומטי.

פרוטוקול Agent2Agent‏ (A2A) הוא תקן פתוח שמאפשר לסוכנים להצהיר על היכולות והזהות שלהם. בדוגמה הבאה אפשר לראות איך פורסים סוכן שמטמיע את פרוטוקול A2A אל Agent Runtime. מידע נוסף על פריסת סוכן

# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
    agent=my_a2a_agent, # Your defined A2A object
    config={
        "display_name": "my-support-agent",
        "description": "An agent that handles support tickets.",
        "requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
    },
)

כשמעדכנים או מוחקים את הסוכן ב-Agent Runtime, השינויים האלה מסתנכרנים אוטומטית עם Agent Registry.

רישום של סוכני Google מובנים

סוכנים מובנים של Google, כמו סוכני Google Workspace ו-Gemini Enterprise, נרשמים אוטומטית במרשם הסוכנים. לא צריך לבצע שום שלבי הגדרה או פריסה. הסוכנים האלה נקלטים וזמינים לגילוי במאגר שלכם.

רישום סוכנים מ-GKE

כדי לרשום סוכנים שנפרסו ב-Google Kubernetes Engine ‏ (GKE), צריך להוסיף את ההערה apphub.cloud.google.com/functional-type: "AGENT" לפריסות. ההערה הזו מזהה את הפריסה כסוכן AI, ומאפשרת למאגר הסוכנים לבצע סריקת אינטרוספקציה.

בדוגמה הבאה מוצג מניפסט של פריסת סוכן GKE. מידע נוסף זמין במאמר פריסה ותזמור של סוכני AI.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the deployment as an AI agent
    apphub.cloud.google.com/functional-type: "AGENT"
spec:
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-agent:1.0.0

כשמחילים את הפריסה, אשכול GKE מנסה באופן אוטומטי לאחזר מטא-נתונים מהסוכן ולסנכרן אותם ישירות למודל הנתונים של Agent Registry.

אימות הרישום

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

המסוף

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

    כניסה ל-Agent Registry

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

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

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

  4. מסננים את הרשימה לפי המיקום של הסוכן או לפי משאב זמן הריצה שלו:

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

    בדף מוצגת רשימה מסוננת של הסוכנים הרשומים לפי התנאים שבחרתם.

gcloud

אם יש לכם כמה סוכנים, או אם אתם רוצים לאשר את הרישום של סוכן ספציפי, כמו סוכן שנרשם אוטומטית, אתם יכולים לסנן את הרשימה לפי המטא-נתונים של הסוכן.

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

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫REGION: האזור של המאגר.
  • ‫FILTER_EXPRESSION: ביטוי הסינון של הסוכנים שרוצים לסנן. לדוגמה, כדי לסנן לפי השם המוצג, אפשר להשתמש ב-displayName='DISPLAY_NAME'. כדי לסנן לפי מזהה ייחודי גלובלי (URN), אפשר להשתמש ב-agentId='urn:agent:AGENT_URN'.

סוכני Google מובנים משתמשים בפורמט URN שתלוי במיקום הפריסה של הסוכן. לדוגמה, אפשר לגלות סוכנים מובנים של Google Workspace על ידי סינון הרשימה לפי המוציא לאור googleapis.com באמצעות --filter="agentId:'urn:agent:googleapis.com:*'"