פרוטוקול Agent2Agent (A2A) הוא פרוטוקול תקשורת פתוח ושפה אוניברסלית לסוכנים. הפרוטוקול מאפשר לסוכנים של מפתחים ופלטפורמות שונים לגלות אחד את השני, לשתף פעולה ולהקצות משימות בצורה מאובטחת. במסמך הזה מוסבר איך אדמינים ב-Gemini Enterprise יכולים לקשר סוכנים שנוצרו באמצעות A2A ומתארחים בכל פלטפורמה ל-Gemini Enterprise, כדי שהם יהיו זמינים למשתמשים באתר Gemini Enterprise.
לפני שמתחילים
חשוב לוודא שיש לכם את הפריטים הבאים:
התפקיד אדמין ב-Gemini Enterprise.
מפעילים את Discovery Engine API. כדי להפעיל את Discovery Engine API בפרויקט ב- Google Cloud, נכנסים לדף Discovery Engine API במסוף Google Cloud .
אפליקציית Gemini Enterprise קיימת. כדי ליצור אפליקציה, עיינו במאמר יצירת אפליקציה.
סוכן שמשתמש בפרוטוקול A2A.
Gemini Enterprise תומך במנגנון הסטרימינג A2A v0.3.
אם אתם משתמשים ב-A2A בגרסה 1.0.0 ואילך, השתמשו בחבילות התאימות שסופקו על ידי ה-SDK כדי לוודא שהסוכן פועל עם המנגנון הקודם (לדוגמה, החבילה
a2acompat/a2av0ל-Go או החבילהa2a.compat.v0_3ל-Python).אם סוכן ה-A2A מתארח ב-Cloud Run, משתמש ישירות בכתובת URL שמוגדרת כברירת מחדל ב-
.run.appודורש אימות, צריך להקצות את התפקיד "מפעיל Cloud Run" (roles/run.invoker) לסוכן השירות של Discovery Engine (זה לא רלוונטי אם Cloud Run נמצא מאחורי Apigee, מאזן עומסים או דומיין מותאם אישית):gcloud projects add-iam-policy-binding <var>PROJECT_ID</var> \ --member="serviceAccount:service-<var>PROJECT_NUMBER</var>@gcp-sa-discoveryengine.iam.gserviceaccount.com" \ --role="roles/run.invoker"מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט. -
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
-
הגדרת אימות והרשאה
בהתאם לסביבת האירוח של הסוכן ולדרישות האבטחה, אתם יכולים להגדיר את שיטת האימות של Gemini Enterprise מול הסוכן, את אופן הגישה של הסוכן למשאבים ולכלים במורד הזרם בשם משתמש הקצה, ואת אופן האבטחה של נקודת הקצה של הסוכן:
- איך Gemini Enterprise מבצע אימות מול הסוכן: איך Gemini Enterprise שולח כותרות של IAM משירות לשירות ושל OAuth 2.0 של משתמשי קצה כשמפעילים את נקודת הקצה של סוכן ה-A2A.
- הגדרת OAuth 2.0 להרשאת משתמשי קצה: מגדירים משאב הרשאה של OAuth 2.0 ב-Gemini Enterprise כדי ש-Gemini Enterprise יקבל אסימון של משתמש קצה וישלח אותו בכותרת
Authorizationכשהוא קורא לסוכן (לדוגמה, כדי להפעיל סוכן A2A שמתארח ב-Agent Runtime ב-Gemini Enterprise Agent Platform או להעביר אסימון משתמש ישירות לקונטיינר של הסוכן). - הגדרת OAuth עם 3 רגליים באמצעות מנהל האימות של Agent Identity: מגדירים ספק אימות OAuth עם 3 רגליים (3LO) במנהל האימות של Agent Identity כדי שסוכן ה-A2A יוכל לבקש אסימונים שהוקצו למשתמשים לפי דרישה לכלים ספציפיים, כמו שרתי Model Context Protocol (MCP) או ממשקי API של צד שלישי.
איך Gemini Enterprise מאמת את הסוכן שלכם
כש-Gemini Enterprise מפעיל סוכן A2A, הוא יכול לשלוח נתוני אימות והרשאה בכותרות של בקשות, בהתאם להגדרות האירוח והאבטחה שלכם:
| כותרת | תיאור |
|---|---|
X-Serverless-Authorization |
אימות IAM משירות לשירות (ל-Cloud Run). אם סוכן ה-A2A שלכם מתארח ב-Cloud Run וכתובת ה-URL של הסוכן היא כתובת URL שמוגדרת כברירת מחדל ב- כש-Gemini Enterprise קורא ישירות לכתובת URL שמוגדרת כברירת מחדל ב- |
Authorization |
הרשאת OAuth 2.0 למשתמשי קצה (להפעלת נקודת קצה, הקשר של משתמש וגישה ל-API). אם מגדירים פרטי כניסה ל-OAuth 2.0 לסוכן ה-A2A (ראו הגדרת OAuth 2.0 להרשאת משתמשי קצה), Gemini Enterprise מקבל טוקן גישה או טוקן של מזהה ב-OAuth 2.0 בשם משתמש הקצה המחובר אחרי שהוא נותן הסכמה, ושולח אותו בכותרת בנציגים שמתארחים ב-Cloud Run, הכותרת |
הגדרת OAuth 2.0 להרשאת משתמשי קצה (אופציונלי)
לסוכני A2A, צריך להגדיר פרטי כניסה ל-OAuth 2.0 ב-Gemini Enterprise אם Agent Endpoint של הסוכן דורש אסימון OAuth 2.0 של משתמש קצה בכותרת Authorization (לדוגמה, כדי להפעיל סוכן A2A שמתארח ב-Agent Runtime או כדי להעביר אסימון משתמש ישירות לקונטיינר של הסוכן). איך Gemini Enterprise מאמת את הסוכן שלכם
אם סוכן ה-A2A משתמש במנהל האימות של Agent Identity ל-OAuth תלת-רגלי ברמת הכלי (לדוגמה, כדי לגשת לשרתי MCP או לממשקי API של צד שלישי בשם המשתמש), קראו את המאמר הגדרת OAuth תלת-רגלי באמצעות מנהל האימות של Agent Identity.
כדי ליצור מזהה לקוח ב-OAuth:
במסוף Google Cloud , בדף APIs & Services, נכנסים לדף Credentials.
-
בוחרים את הפרויקט Google Cloud שמכיל את מקור הנתונים שאליו רוצים לתת לנציג גישה. לדוגמה, בוחרים את הפרויקט שמכיל את מערך הנתונים ב-BigQuery שהנציג צריך לשלוח אליו שאילתות.
לוחצים על Create credentials ובוחרים באפשרות OAuth client ID.
ב-סוג אפליקציה, בוחרים אפליקציית אינטרנט.
בקטע Authorized redirect URIs, מוסיפים את כתובות ה-URI הבאות:
https://vertexaisearch.cloud.google.com/oauth-redirecthttps://vertexaisearch.cloud.google.com/static/oauth/oauth.html
לוחצים על יצירה.
בחלונית לקוח OAuth נוצר, לוחצים על Download JSON. קובץ ה-JSON שהורדתם כולל את
Client ID,Authorization URI,Token URIו-Client secretשל הפרויקט שנבחר ב-Google Cloud . אתם צריכים את הפרטים האלה כדי ליצור משאב הרשאה.
הגדרת OAuth תלת-רגלי באמצעות מנהל האימות של Agent Identity (אופציונלי)
אם סוכן ה-A2A שלכם נוצר באמצעות הערכה לפיתוח סוכנים (ADK) ומשתמש במנהל האימות של Agent Identity ל-OAuth תלת-רגלי (3LO), הסוכן יכול לבצע אימות לשרתי MCP, לשירותי Google Cloudאו לממשקי API של צד שלישי במורד הזרם בשם המשתמש שמחובר לחשבון.
כשכלי בסוכן ה-A2A דורש הסכמה מהמשתמש, Gemini Enterprise מנהל באופן אוטומטי את תהליך העבודה של 3LO בצד הלקוח:
- בקשת הסכמה: כשהסוכן מחזיר הפרעה לכלי
adk_request_credential(TASK_STATE_AUTH_REQUIRED), אתר Gemini Enterprise מבקש מהמשתמש להיכנס לחשבון ופותח את ה-URI של ההרשאה מספק האימות. - אימות המשתמש ואחסון הטוקן: אחרי שהמשתמש נותן הסכמה, ספק האימות מפנה לנקודת הקצה לאימות של Gemini Enterprise (
https://vertexaisearch.cloud.google.com/validateUserId). Gemini Enterprise מאמת את מצב הסשן ומסיים את תהליך האימות של פרטי הכניסה באמצעות מנהל האימות של Agent Identity. - המשך השיחה: Gemini Enterprise שולח את התשובה המלאה של
adk_request_credentialבחזרה לסוכן ה-A2A, שמאחזר את טוקן הגישה של המשתמש מספק האימות ומפעיל את הכלי.
מכיוון ש-Gemini Enterprise מטפל בבקשת ההסכמה, בנקודת הקצה לאימות ובחידוש השיחה, אתם לא צריכים להטמיע אפליקציית ממשק משתמש מותאמת אישית בצד הלקוח.
שלב 1: הגדרת ספק אימות OAuth תלת-רגלי
פועלים לפי השלבים שמפורטים במאמר אימות באמצעות OAuth תלת-רגלי עם מנהל אימות כדי להפעיל את Agent Identity API (agentidentity.googleapis.com), להגדיר את אפליקציית הלקוח של OAuth וליצור ספק אימות OAuth תלת-רגלי.
כשמגדירים את לקוח ה-OAuth ואת ספק האימות לשימוש ב-Gemini Enterprise, צריך לכלול את ההגדרות הבאות:
מזהי URI מורשים להפניה אוטומטית: בהגדרות של לקוח OAuth, מוסיפים את מזהה ה-URI להפניה אוטומטית של ספק האימות:
https://agentidentitycredentials.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/authProviders/<var>AUTH_PROVIDER_NAME</var>/oauthcallbackאם אתם משתמשים באותו לקוח OAuth למשאב ההרשאה של סוכן Gemini Enterprise (לדוגמה, כדי לאפשר ל-Gemini Enterprise להפעיל סוכן A2A שמתארח ב-Agent Runtime), צריך לכלול גם את ה-URI להפניה אוטומטית של Gemini Enterprise (
https://vertexaisearch.cloud.google.com/oauth-redirect).המשך URI: מגדירים את המשך ה-URI (כברירת המחדל של המשך ה-URI בספק האימות או כ-
continue_uriבקוד הנציג) לנקודת הקצה לאימות של Gemini Enterprise:https://vertexaisearch.cloud.google.com/validateUserId
שלב 2: מגדירים את קוד סוכן ה-A2A
כשיוצרים סוכן ADK ועוטפים אותו ב-A2aAgent לפריסה ב-Agent Runtime, צריך לוודא שקוד הסוכן עומד בדרישות הבאות:
- התקנת גרסאות החבילה הנדרשות: צריך לכלול את
a2a-sdk[http-server]>=1.0.0,google-cloud-aiplatform[agent_engines,adk]>=1.156.0ו-google-adk[a2a,agent-identity,mcp]>2.7.1בדרישות הפריסה. - הגדרת
continue_uriל-Gemini Enterprise: מגדירים אתcontinue_uriלערך"https://vertexaisearch.cloud.google.com/validateUserId"ב-GcpAuthProviderSchemeאו ב-AgentRegistry.get_mcp_toolset(אלא אם הגדרתם אותו ככתובת ה-URI להמשך שמוגדרת כברירת מחדל בספק האימות). - רישום של
GcpAuthProviderבתוך הפונקציה של ה-runner builder: קוראים ל-CredentialManager.register_auth_provider(GcpAuthProvider())בתוך הפונקציה שיוצרת את ה-Runnerבתהליך ה-worker של הקונטיינר שנפרס, ולא רק ברמה העליונה של המודול. - שימוש ב-
A2aAgentExecutorהמובנה: עוברA2aAgentExecutor(runner=build_runner)(from google.adk.a2a.executor.a2a_agent_executor import A2aAgentExecutor) ל-A2aAgent. אל תשתמשו ב-AgentExecutorבהתאמה אישית שבודק רק אתevent.is_final_response(), כיA2aAgentExecutorנדרש כדי להמיר פסיקות (interrupts) שלadk_request_credentialלמצב המשימהTASK_STATE_AUTH_REQUIREDA2A. - כוללים את גרסה
0.3של פרוטוקול A2A ב-AgentCard: מוסיפיםAgentInterfaceעםprotocol_version=PROTOCOL_VERSION_0_3ו-protocol_binding=TransportProtocol.HTTP_JSONל-agent_card.supported_interfacesלצד ממשק ברירת המחדל של1.0, כדי ש-Gemini Enterprise יוכל לתקשר עם הסוכן שלכם דרך נתיבי A2A בגרסה 0.3.
ADK + A2A
בדוגמה הבאה מוגדר סוכן A2A של ADK שמשתמש ב-GcpAuthProviderScheme עם McpToolset (או AgentRegistry.get_mcp_toolset) כדי לאמת מול שרת MCP בשם המשתמש:
from a2a.types import AgentInterface, AgentSkill from a2a.utils.constants import PROTOCOL_VERSION_0_3, PROTOCOL_VERSION_1_0, TransportProtocol from google.adk.a2a.executor.a2a_agent_executor import A2aAgentExecutor from google.adk.agents import LlmAgent from google.adk.artifacts.in_memory_artifact_service import InMemoryArtifactService from google.adk.auth.credential_manager import CredentialManager from google.adk.integrations.agent_identity import GcpAuthProvider, GcpAuthProviderScheme from google.adk.memory.in_memory_memory_service import InMemoryMemoryService from google.adk.runners import Runner from google.adk.sessions.in_memory_session_service import InMemorySessionService from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams from google.adk.tools.mcp_tool.mcp_toolset import McpToolset from vertexai.agent_engines.templates.a2a import A2aAgent, create_agent_card # Redirect URI for Gemini Enterprise user validation CONTINUE_URI = "https://vertexaisearch.cloud.google.com/validateUserId" auth_scheme = GcpAuthProviderScheme( name="projects/PROJECT_ID/locations/LOCATION/authProviders/AUTH_PROVIDER_NAME", scopes=["OAUTH_SCOPE"], continue_uri=CONTINUE_URI, ) mcp_tools = McpToolset( connection_params=StreamableHTTPConnectionParams( url="https://YOUR_MCP_SERVER_URL" ), auth_scheme=auth_scheme, ) # Alternatively, if your MCP server is registered in Agent Registry # with an outbound auth provider binding, use AgentRegistry.get_mcp_toolset: # from google.adk.integrations.agent_registry import AgentRegistry # registry = AgentRegistry(project_id="PROJECT_ID", location="LOCATION") # mcp_tools = registry.get_mcp_toolset( # mcp_server_name="projects/PROJECT_ID/locations/LOCATION/mcpServers/MCP_SERVER_ID", # continue_uri=CONTINUE_URI, # ) adk_agent = LlmAgent( model="gemini-2.5-flash", name="AGENT_NAME", description="AGENT_DESCRIPTION", instruction="AGENT_INSTRUCTIONS", tools=[mcp_tools], ) def build_runner() -> Runner: # Register GcpAuthProvider inside the deployed worker process CredentialManager.register_auth_provider(GcpAuthProvider()) return Runner( app_name=adk_agent.name, agent=adk_agent, artifact_service=InMemoryArtifactService(), session_service=InMemorySessionService(), memory_service=InMemoryMemoryService(), ) agent_card = create_agent_card( agent_name="AGENT_DISPLAY_NAME", description="AGENT_DESCRIPTION", skills=[ AgentSkill( id="SKILL_ID", name="SKILL_NAME", description="SKILL_DESCRIPTION", tags=[], ) ], ) agent_card.supported_interfaces = [ AgentInterface( protocol_binding=TransportProtocol.HTTP_JSON, protocol_version=PROTOCOL_VERSION_1_0, url="", ), AgentInterface( protocol_binding=TransportProtocol.HTTP_JSON, protocol_version=PROTOCOL_VERSION_0_3, url="", ), ] a2a_agent = A2aAgent( agent_card=agent_card, agent_executor_builder=lambda: A2aAgentExecutor(runner=build_runner), )
ADK + A2A
בדוגמה הבאה מגדירים סוכן A2A של ADK שמשתמש ב-AuthenticatedFunctionTool עם GcpAuthProviderScheme כדי להפעיל API בארכיטקטורת REST של צד שלישי או של Google Cloudבשם המשתמש:
from a2a.types import AgentInterface, AgentSkill from a2a.utils.constants import PROTOCOL_VERSION_0_3, PROTOCOL_VERSION_1_0, TransportProtocol from google.adk.a2a.executor.a2a_agent_executor import A2aAgentExecutor from google.adk.agents import LlmAgent from google.adk.artifacts.in_memory_artifact_service import InMemoryArtifactService from google.adk.auth.auth_credential import AuthCredential from google.adk.auth.auth_tool import AuthConfig from google.adk.auth.credential_manager import CredentialManager from google.adk.integrations.agent_identity import GcpAuthProvider, GcpAuthProviderScheme from google.adk.memory.in_memory_memory_service import InMemoryMemoryService from google.adk.runners import Runner from google.adk.sessions.in_memory_session_service import InMemorySessionService from google.adk.tools.authenticated_function_tool import AuthenticatedFunctionTool import httpx from vertexai.agent_engines.templates.a2a import A2aAgent, create_agent_card # Redirect URI for Gemini Enterprise user validation CONTINUE_URI = "https://vertexaisearch.cloud.google.com/validateUserId" auth_config = AuthConfig( auth_scheme=GcpAuthProviderScheme( name="projects/PROJECT_ID/locations/LOCATION/authProviders/AUTH_PROVIDER_NAME", scopes=["OAUTH_SCOPE"], continue_uri=CONTINUE_URI, ) ) async def call_external_api(credential: AuthCredential, query: str) -> str: """Calls an external API using the end user's OAuth token.""" token = None if credential and credential.http and credential.http.credentials: token = credential.http.credentials.token if not token: return "Error: No authentication token available." async with httpx.AsyncClient() as client: response = await client.get( "https://YOUR_API_ENDPOINT", headers={"Authorization": f"Bearer {token}"}, params={"q": query}, ) response.raise_for_status() return response.text authenticated_tool = AuthenticatedFunctionTool( func=call_external_api, auth_config=auth_config, ) adk_agent = LlmAgent( model="gemini-2.5-flash", name="AGENT_NAME", description="AGENT_DESCRIPTION", instruction="AGENT_INSTRUCTIONS", tools=[authenticated_tool], ) def build_runner() -> Runner: # Register GcpAuthProvider inside the deployed worker process CredentialManager.register_auth_provider(GcpAuthProvider()) return Runner( app_name=adk_agent.name, agent=adk_agent, artifact_service=InMemoryArtifactService(), session_service=InMemorySessionService(), memory_service=InMemoryMemoryService(), ) agent_card = create_agent_card( agent_name="AGENT_DISPLAY_NAME", description="AGENT_DESCRIPTION", skills=[ AgentSkill( id="SKILL_ID", name="SKILL_NAME", description="SKILL_DESCRIPTION", tags=[], ) ], ) agent_card.supported_interfaces = [ AgentInterface( protocol_binding=TransportProtocol.HTTP_JSON, protocol_version=PROTOCOL_VERSION_1_0, url="", ), AgentInterface( protocol_binding=TransportProtocol.HTTP_JSON, protocol_version=PROTOCOL_VERSION_0_3, url="", ), ] a2a_agent = A2aAgent( agent_card=agent_card, agent_executor_builder=lambda: A2aAgentExecutor(runner=build_runner), )
שלב 3: פורסים את סוכן ה-A2A עם Agent Identity ונותנים גישה
פורסים את
A2aAgentב-Agent Runtime באמצעותidentity_type=types.IdentityType.AGENT_IDENTITY:import vertexai from vertexai import types client = vertexai.Client( project="<var>PROJECT_ID</var>", location="<var>LOCATION</var>", http_options=dict(api_version="v1beta1"), ) remote_a2a_agent = client.agent_engines.create( agent=a2a_agent, config={ "display_name": "<var>AGENT_DISPLAY_NAME</var>", "identity_type": types.IdentityType.AGENT_IDENTITY, "requirements": [ "a2a-sdk[http-server]>=1.0.0", "google-cloud-aiplatform[agent_engines,adk]>=1.156.0", "google-adk[a2a,agent-identity,mcp]>2.7.1", "google-genai", "httpx", ], }, )אחרי שהפריסה מסתיימת, נותנים את התפקיד Agent Identity User (
roles/agentidentity.user) בספק האימות לישות ה-SPIFFE של הסוכן שנפרס:gcloud agent-identity auth-providers add-iam-policy-binding <var>AUTH_PROVIDER_NAME</var> \ --project="<var>PROJECT_ID</var>" \ --location="<var>LOCATION</var>" \ --role="roles/agentidentity.user" \ --member="principal://agents.global.org-<var>ORGANIZATION_ID</var>.system.id.goog/resources/aiplatform/projects/<var>PROJECT_NUMBER</var>/locations/<var>LOCATION</var>/reasoningEngines/<var>ENGINE_ID</var>"מחליפים את מה שכתוב בשדות הבאים:
-
AUTH_PROVIDER_NAME: השם של ספק האימות. -
PROJECT_ID: מזהה הפרויקט. -
LOCATION: האזור שבו נפרסו ספק האימות והנציג (לדוגמה,us-central1). -
ORGANIZATION_ID: מזהה הארגון ב- Google Cloud. -
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . -
ENGINE_ID: מזהה המשאב של הסוכן שלreasoningEnginesשנפרס.
-
רושמים את סוכן ה-A2A שנפרס ב-Gemini Enterprise באמצעות רישום סוכן A2A ב-Gemini Enterprise (סוכן בהתאמה אישית באמצעות A2A) או ייבוא סוכני A2A מ-Agent Registry (סוכן בהתאמה אישית באמצעות Agent Runtime). הסוכן מתארח ב-Agent Runtime, לכן צריך להגדיר משאב הרשאה של OAuth 2.0 ב-Gemini Enterprise עם ההיקף
https://www.googleapis.com/auth/cloud-platformכדי ש-Gemini Enterprise יוכל להפעיל את נקודת הקצה של Agent Runtime.
אבטחת נקודת הקצה של סוכן ה-A2A
כדי לראות את כותרות האימות ש-Gemini Enterprise שולח לסוכן ה-A2A, עיינו בקטע איך Gemini Enterprise מאמת את הסוכן. כשמאבטחים את נקודת הקצה של הסוכן או את שער ה-API שלפניה, כדאי להביא בחשבון את הדברים הבאים:
- סכימות אבטחה של כרטיס הסוכן: Gemini Enterprise לא משתמש בשדות
securitySchemesו-securityשל כרטיס הסוכן כדי לאמת את הסוכן. - מפתחות API וכותרות בהתאמה אישית: Gemini Enterprise לא תומך בסכימת האבטחה
apiKey, ואין דרך להוסיף מפתחות API סטטיים או ערכים אחרים של כותרות בהתאמה אישית לבקשות שהוא שולח לסוכן. - טוקן מזהה של סוכן שירות: Gemini Enterprise שולח את הכותרת
X-Serverless-Authorizationרק אם כתובת ה-URL של הסוכן היא כתובת ברירת המחדל של Cloud Run שמסתיימת ב-.run.app. אם כתובת ה-URL של הנציג משתמשת בדומיין מותאם אישית, במאזן עומסים או ב-API Gateway, Gemini Enterprise לא שולח את הכותרת הזו. - אסימון של משתמש קצה: אם מגדירים OAuth 2.0 לנציג, Gemini Enterprise שולח את האסימון של משתמש הקצה מספק ה-OAuth 2.0 בכותרת
Authorization.
אבטחת Agent Endpoint באמצעות Apigee
אם אתם חושפים את סוכן ה-A2A דרך שרת proxy ל-API של Apigee, שרת ה-proxy מקבל את הטוקן של משתמש הקצה בכותרת Authorization אבל לא מקבל את הכותרת X-Serverless-Authorization. כדי לאבטח את שרת ה-proxy, מבצעים את הפעולות הבאות:
- מגדירים את OAuth 2.0 להרשאת משתמשי קצה לנציג (באמצעות מזהה לקוח ב-OAuth 2.0 או ספק OAuth 2.0 של צד שלישי), ומספקים את פרטי OAuth 2.0 כשרושמים את הנציג. Google Cloud כדי לאבטח שרת proxy ל-API של Apigee, צריך להגדיר את OAuth 2.0. אל תדלגו על שלב ההרשאה במהלך הרישום.
- בכרטיס הנציג, מגדירים את
urlלכתובת ה-URL של שרת ה-proxy ל-API ב-Apigee. - ב-proxy ל-API, מאמתים את האסימון של משתמש הקצה בכותרת
Authorizationלפני שמעבירים את הבקשה לנציג. בוחרים את המדיניות של Apigee בהתאם לפורמט האסימון שספק ה-OAuth 2.0 מנפיק:- ספקי OAuth 2.0 של צד שלישי שמנפיקים אסימוני גישה חתומים של JWT:
משתמשים במדיניות VerifyJWT כדי לאמת את חתימת האסימון מול ה-URI של ה-JSON Web Key Set (JWKS) הציבורי של הספק, ולאמת את הצהרות המנפיק (
iss) והקהל (aud). - Google OAuth 2.0 (
accounts.google.com): אסימוני הגישה של Google OAuth 2.0 (ya29...) הם אסימונים אטומים ולא אסימוני JWT חתומים. משתמשים במדיניות ServiceCallout כדי לשלוח קריאה ל-https://oauth2.googleapis.com/tokeninfoולאמת את השדות של הקהל (aud) ו-scope.
- ספקי OAuth 2.0 של צד שלישי שמנפיקים אסימוני גישה חתומים של JWT:
משתמשים במדיניות VerifyJWT כדי לאמת את חתימת האסימון מול ה-URI של ה-JSON Web Key Set (JWKS) הציבורי של הספק, ולאמת את הצהרות המנפיק (
רישום סוכן A2A ב-Gemini Enterprise
אתם יכולים לרשום את סוכן ה-A2A ב-Gemini Enterprise באמצעות מסוףGoogle Cloud או API בארכיטקטורת REST. כך הסוכן יהיה זמין למשתמשים באפליקציית Gemini Enterprise.
המסוף
כדי לרשום סוכן A2A באמצעות מסוף Google Cloud :
במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
לוחצים על שם האפליקציה שבה רוצים לרשום את הנציג.
לוחצים על נציגים > הוספת נציגים.
בקטע Choose an agent type, לוחצים על Add באפשרות Custom agent via A2A.
בשדה Agent card JSON, מזינים את פרטי כרטיס הנציג בפורמט JSON. רשימה מלאה של השדות הזמינים מופיעה במפרט הרשמי של פרוטוקול Agent2Agent (A2A). בדוגמה הבאה נעשה שימוש רק בשדות החובה.
לדוגמה:
{ "protocolVersion": "0.3", "name": "Hello World Agent", "description": "Just a hello world agent", "url": "https://example.com/myagent", "iconUrl": "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iOTkiIGhlaWdodD0iOTkiIHN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOmdyYXk7IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik0zMyAwaDMzdjMzSDMzeiBNMCAzM2gzM3YzM0gweiBNNjYgMzNoMzN2MzNINjZ6IE0zMyA2NmgzM3YzM0gzM3oiIGZpbGw9ImJsdWUiLz48L3N2Zz4=", "version": "1.0.0", "capabilities": { }, "skills": [ { "id": "data-analysis", "name": "Data Analysis", "description": "Data analysis", "tags": [] } ], "defaultInputModes": [ "text/plain" ], "defaultOutputModes": [ "text/plain" ] }לוחצים על תצוגה מקדימה של פרטי הנציג > הבא.
משלימים את ההגדרה באחת מהשיטות הבאות:
- אם אתם לא רוצים שהנציג ייגש למשאבים של Google Cloud בשמכם, ונקודת הקצה של הנציג לא דורשת כותרת
Authorization, לחצו על Skip & Finish כדי לדלג על השלב הזה. - אם הגדרתם 3LO עם מנהל אימות, לוחצים על Skip & Finish והנציג מבקש גישה באופן דינמי.
אם לא הגדרתם 3LO עם מנהל האימות או אם Agent Endpoint דורש כותרת
Authorization(לדוגמה, כשמאבטחים proxy ל-API של Apigee), פועלים לפי השלבים הבאים:מזינים את מזהה הלקוח, סוד הלקוח, כתובת ה-URI להרשאה וכתובת ה-URI לאסימון שיצרתם בקטע הגדרת OAuth 2.0 להרשאת משתמשי קצה (אופציונלי).
מזינים את היקפי ההרשאות.
לוחצים על סיום.
- אם אתם לא רוצים שהנציג ייגש למשאבים של Google Cloud בשמכם, ונקודת הקצה של הנציג לא דורשת כותרת
REST
כדי לרשום סוכן A2A באמצעות ה-API בארכיטקטורת REST:
הוספת משאב ההרשאה ל-Gemini Enterprise (אופציונלי)
אם הנציג צריך לגשת למשאבים של Google Cloud בשם המשתמש, מריצים את הפקודה הבאה כדי לרשום ב-Gemini Enterprise את משאב ההרשאה שיצרתם בקטע הגדרת פרטי ההרשאה (אופציונלי):
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/authorizations?authorizationId=AUTH_ID" \
-d '{
"name": "projects/PROJECT_NUMBER/locations/LOCATION/authorizations/AUTH_ID",
"serverSideOauth2": {
"clientId": "OAUTH_CLIENT_ID",
"clientSecret": "OAUTH_CLIENT_SECRET",
"authorizationUri": "OAUTH_AUTH_URI",
"tokenUri": "OAUTH_TOKEN_URI"
}
}'
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט. -
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . -
ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
LOCATION: האזור של מאגר הנתונים:global,usאוeu -
AUTH_ID: המזהה של משאב ההרשאה. זהו מזהה אלפאנומרי שרירותי שאתם מגדירים. תצטרכו להשתמש במזהה הזה בהמשך, כשתרשמו נציג שדורש תמיכה ב-OAuth. -
OAUTH_CLIENT_ID: מזהה הלקוח של OAuth 2.0 שקיבלתם כשיצרתם את פרטי הכניסה ל-OAuth. -
OAUTH_CLIENT_SECRET: סוד הלקוח של OAuth 2.0 שקיבלתם כשיצרתם את פרטי הכניסה ל-OAuth.
OAUTH_AUTH_URI: ה-URI של ההרשאה. כדי לאשר את האפליקציה, צריך ליצור URI ספציפי להרשאה באמצעות הפרטים מקובץ ה-JSON של פרטי הכניסה ל-OAuth. מעתיקים את התבנית הבאה ומחליפים את הערכים הזמניים לשמירת מקום בערכים הספציפיים שלכם.https://accounts.google.com/o/oauth2/v2/auth?client_id=OAUTH_CLIENT_ID&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=YOUR_CUSTOM_SCOPES&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent
YOUR_CUSTOM_SCOPES: אתם יכולים להוסיף את היקפי ההרשאות שאתם צריכים. לדוגמה, מחרוזת היקף ההרשאות הבאה של OAuth מבקשת גישה לקריאה בלבד ל-Google Drive ול-Google Docs.scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdrive.readonly%20https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdocuments.readonly
OAUTH_TOKEN_URI: ה-URI של האסימון שקיבלתם כשיצרתם את פרטי הכניסה ל-OAuth.
מידע נוסף על פרמטרים של URI להרשאה.
כדי לוודא שה-URI פועל בצורה תקינה, צריך לבדוק את השדות הבאים:
| פרמטר | ערך או פעולה |
|---|---|
client_id |
מחליפים בערך של client_id שמופיע בקובץ ה-JSON שהורדתם. |
redirect_uri |
לא לשנות. חייב להיות
https://vertexaisearch.cloud.google.com/static/oauth/oauth.html. |
scope |
מציינים את היקפי ההרשאות של Google API שהאפליקציה צריכה לגשת אליהם בשם המשתמש. לדוגמה, כדי לתת גישה ל-BigQuery, משתמשים בהיקף ההרשאות אם משתמשים בכמה היקפי הרשאות, צריך להפריד ביניהם באמצעות רווח, שהופך ל- |
include_granted_scopes |
חייב להיות true. |
response_type |
כדי לקבל קוד הרשאה, צריך להיות code. |
access_type |
צריך להגדיר את הערך offline כדי להבטיח שתקבלו טוקן רענון. |
prompt |
מגדירים את הערך consent כדי לוודא שלמשתמש תמיד יוצג מסך הסכמה. |
רישום סוכן A2A
כדי ליצור ולרשום סוכן ב-Gemini Enterprise, משתמשים ב-method agents.create. בפקודה הבאה נעשה שימוש רק בשדות החובה. רשימה מלאה של השדות הזמינים מופיעה במפרט הרשמי של פרוטוקול Agent2Agent (A2A).
כדי לרשום את סוכן ה-A2A ב-Gemini Enterprise, מריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents \
-d '
{
"name": "AGENT_NAME",
"displayName": "AGENT_DISPLAY_NAME",
"description": "AGENT_DESCRIPTION",
"a2aAgentDefinition": {
"jsonAgentCard": "{\"protocolVersion\":\"PROTOCOLVERSION\",\"name\":\"AGENT_NAME\",\"description\":\"AGENT_DESCRIPTION\",\"url\":\"AGENT_URL\",\"version\":\"AGENT_VERSION\",\"defaultInputModes\":[\"INPUT_MODE\"],\"defaultOutputModes\":[\"OUTPUT_MODE\"],\"capabilities\":{ CAPABILITIES },\"skills\":[SKILLS]}"
},
"authorizationConfig": {
"agentAuthorization": "projects/PROJECT_ID/locations/LOCATION/authorizations/AUTH_ID"
}
}
'
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
LOCATION: האזור של מאגר הנתונים:global,usאוeu -
PROJECT_ID: מזהה הפרויקט. -
APP_ID: מזהה האפליקציה שבה רוצים לרשום את הנציג. -
AGENT_NAME: המזהה הייחודי של הנציג. -
AGENT_DISPLAY_NAME: השם של הנציג שמוצג באפליקציית האינטרנט. -
AGENT_DESCRIPTION: תיאור של מה שהסוכן יכול לעשות. -
PROTOCOLVERSION: גרסת פרוטוקול ה-A2A שהסוכן תומך בה. למידע נוסף על הגרסאות הנתמכות, קראו את נתוני הגרסה של A2A. -
AGENT_URL: כתובת ה-URL של נקודת הקצה של הנציג. -
AGENT_VERSION: גרסת הסוכן. INPUT_MODE: סוג המדיה שמוגדר כברירת מחדל לקלט. לדוגמה,application/jsonאוtext/plain.-
OUTPUT_MODE: סוג המדיה שמוגדר כברירת מחדל לפלט. לדוגמה,text/plain"אוimage/png. -
CAPABILITIES: אובייקט JSON שמכיל תכונות A2A נתמכות. לדוגמה,\"streaming\": trueאו\"pushNotifications\": false. -
SKILLS: רשימה של אובייקטים מסוגAgentSkillשהנציג מציע. -
authorizationConfig: אם קיבלתם את פרטי ההרשאה ואתם רוצים שהסוכן ייגש למשאבים של Google Cloud בשם המשתמש, הוסיפו את השדהauthorization_configלמשאב ה-JSON.-
AUTH_ID: הערך שבו השתמשתם בשביל AUTH_ID בקטע הוספת משאב הרשאה ל-Gemini Enterprise.
-
הצגת פרטי המחבר ופרטים ליצירת קשר של נציג (אופציונלי)
כברירת מחדל, סוכן A2A שאתם רושמים לא מציג מחבר ב-Gemini Enterprise. כדי להציג מי יצר את הנציג ואל מי המשתמשים יכולים לפנות לגביו, מוסיפים את תוסף המטא-נתונים של הנציג לשדה capabilities.extensions בקובץ ה-JSON של כרטיס הנציג שמשמש לרישום או לעדכון של הנציג:
{
"capabilities": {
"extensions": [
{
"uri": "https://www.googleapis.com/gemini-enterprise/a2a/extensions/agent_metadata/v1",
"params": {
"authorName": "Example Team",
"contactEmail": "agent-support@example.com"
}
}
]
}
}
משאירים את השדות האחרים של כרטיס הנציג מדוגמת הרישום לצד capabilities. ב-API בארכיטקטורת REST, הסיומת היא חלק מהמחרוזת jsonAgentCard עם תו בריחה (escape).
השדה params תומך בערכים הבאים. שני השדות הם אופציונליים.
| פרמטר | תיאור |
|---|---|
authorName |
השם של האדם, הצוות או החברה שפיתחו את הנציג. בגלריית הסוכנים, השם מופיע בכרטיס של הסוכן בתור By AUTHOR_NAME, ובתיבת הדו-שיח Agent Info הוא מופיע בתור Author. השם הזה מוצג בגלריה רק אם לסוכן אין שם בעלים משלו. שמות שמכילים את המילה Google לא מוצגים, כדי שלא יתבלבלו ביניהם לבין נציגים שנוצרו על ידי Google. |
contactEmail |
כתובת אימייל שבה המשתמשים יכולים ליצור קשר עם המחבר. בתיבת הדו-שיח Agent Info הוא מופיע בתור Contact. |
כל ערך חייב להיות מחרוזת של עד 256 תווים, ו-contactEmail חייב להיות כתובת אימייל תקינה. Gemini Enterprise מתעלם מערכים שלא עומדים בדרישות האלה. Gemini Enterprise לא מאמת את שם המחבר או את כתובת האימייל ליצירת קשר.
רשימת הסוכנים שמחוברים לאפליקציה
דוגמת הקוד הבאה מראה איך אפשר לקבל את הפרטים של כל הנציגים שמחוברים לאפליקציה:
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents"
מחליפים את המשתנים בערכים:
- ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- LOCATION: האזור של האפליקציה:
global,usאוeu. - APP_ID: המזהה של אפליקציית Gemini Enterprise.
אם הנציג לא נוצר מראש על ידי Google, התשובה כוללת שדה name בשורות הראשונות. הערך של השדה הזה מכיל את מזהה הנציג בסוף הנתיב. לדוגמה, בתשובה הבאה מזהה הנציג הוא 12345678901234567890:
{
"name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
...
}
איך רואים את הפרטים של סוכן A2A
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים את הפרטים של סוכן שנרשם ב-Gemini Enterprise:
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"
מחליפים את המשתנים בערכים:
- ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- LOCATION: האזור של האפליקציה:
global,usאוeu. - APP_ID: המזהה של אפליקציית Gemini Enterprise.
- AGENT_ID: מזהה הנציג. כדי למצוא את מזהה הנציג, אפשר להציג את רשימת הנציגים שמקושרים לאפליקציה.
עדכון סוכן A2A
אתם יכולים לשנות את הפרטים של סוכן A2A קיים שרשום ב-Gemini Enterprise באמצעות מסוף Google Cloud או ה-API בארכיטקטורת REST.
המסוף
כדי לעדכן סוכן A2A באמצעות מסוף Google Cloud , פועלים לפי השלבים הבאים:
במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
לוחצים על שם האפליקציה שכוללת את הנציג שרוצים לעדכן.
לוחצים על נציגים.
לוחצים על השם של סוכן A2A (בהתאמה אישית) שרוצים לעדכן, ואז לוחצים על Edit.
בשדה Agent card JSON, מעדכנים את פרטי כרטיס הנציג בפורמט JSON. רשימה מלאה של השדות הזמינים מופיעה במפרט הרשמי של פרוטוקול Agent2Agent (A2A). בדוגמה הבאה נעשה שימוש רק בשדות החובה.
לדוגמה:
{ "protocolVersion": "0.3", "name": "Hello World Agent", "description": "Just a hello world agent", "url": "https://example.com/myagent", "iconUrl": "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iOTkiIGhlaWdodD0iOTkiIHN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOmdyYXk7IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik0zMyAwaDMzdjMzSDMzeiBNMCAzM2gzM3YzM0gweiBNNjYgMzNoMzN2MzNINjZ6IE0zMyA2NmgzM3YzM0gzM3oiIGZpbGw9ImJsdWUiLz48L3N2Zz4=", "version": "1.1.0", "capabilities": { }, "skills": [ { "id": "data-analysis", "name": "Data Analysis", "description": "Data analysis", "tags": [] } ], "defaultInputModes": [ "text/plain" ], "defaultOutputModes": [ "text/plain" ] }לוחצים על Save.
REST
כדי לעדכן את הפרטים של סוכן A2A שרשום ב-Gemini Enterprise, משתמשים ב-method agents.patch. בפקודה הבאה נעשה שימוש רק בשדות החובה. רשימה מלאה של השדות הזמינים מופיעה במפרט הרשמי של פרוטוקול Agent2Agent (A2A).
כדי לעדכן את סוכן ה-A2A באמצעות Gemini Enterprise, מריצים את הפקודה הבאה:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID \
-d '
{
"name": "AGENT_NAME",
"displayName": "AGENT_DISPLAY_NAME",
"description": "AGENT_DESCRIPTION",
"a2aAgentDefinition": {
"jsonAgentCard": "{\"protocolVersion\":\"PROTOCOLVERSION\",\"name\":\"AGENT_NAME\",\"description\":\"AGENT_DESCRIPTION\",\"url\":\"AGENT_URL\",\"version\":\"AGENT_VERSION\",\"defaultInputModes\":[\"INPUT_MODE\"],\"defaultOutputModes\":[\"OUTPUT_MODE\"],\"capabilities\":{ CAPABILITIES },\"skills\":[SKILLS]}"
},
"authorizationConfig": {
"agentAuthorization": "projects/PROJECT_ID/locations/LOCATION/authorizations/AUTH_ID"
}
}
'
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
LOCATION: האזור של מאגר הנתונים:global,usאוeu. -
PROJECT_ID: מזהה הפרויקט. -
APP_ID: מזהה האפליקציה שבה רוצים לרשום את הנציג. - AGENT_ID: מזהה הנציג. כדי למצוא את מזהה הנציג, אפשר להציג את רשימת הנציגים שמקושרים לאפליקציה.
-
AGENT_NAME: המזהה הייחודי של הנציג. -
AGENT_DISPLAY_NAME: השם של הנציג שמוצג באפליקציית האינטרנט. -
AGENT_DESCRIPTION: תיאור של מה שהסוכן יכול לעשות. -
PROTOCOLVERSION: גרסת פרוטוקול A2A שהסוכן תומך בה. למידע נוסף על הגרסאות הנתמכות, קראו את נתוני הגרסה של A2A. -
AGENT_URL: כתובת ה-URL של נקודת הקצה של הנציג. -
AGENT_VERSION: גרסת הסוכן. INPUT_MODE: סוג המדיה שמוגדר כברירת מחדל לקלט. לדוגמה,application/jsonאוtext/plain.-
OUTPUT_MODE: סוג המדיה שמוגדר כברירת מחדל לפלט. לדוגמה,text/plainאוimage/png. -
CAPABILITIES: אובייקט JSON שמכיל תכונות A2A נתמכות. לדוגמה,\"streaming\": trueאו\"pushNotifications\": false. -
SKILLS: רשימה של אובייקטים מסוגAgentSkillשהנציג מציע. -
authorizationConfig: אם קיבלתם את פרטי ההרשאה ואתם רוצים שהסוכן ייגש למשאבים של Google Cloud בשם המשתמש, הוסיפו את השדהauthorization_configלמשאב ה-JSON.-
AUTH_ID: הערך שבו השתמשתם בשביל AUTH_ID בקטע הוספת משאב הרשאה ל-Gemini Enterprise.
-
מחיקת סוכן A2A
דוגמת הקוד הבאה מראה איך אפשר למחוק נציג שמחובר לאפליקציה:
REST
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"
מחליפים את המשתנים בערכים:
- ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- LOCATION: האזור של האפליקציה:
global,usאוeu - APP_ID: המזהה של אפליקציית Gemini Enterprise.
- AGENT_ID: מזהה הנציג. כדי למצוא את מזהה הנציג, אפשר להציג את רשימת הנציגים שמקושרים לאפליקציה.
המאמרים הבאים
- משתמשים בסוכן שנרשמתם איתו ל-Gemini Enterprise באתר.