feat: add agent_card to agent engine spec

PiperOrigin-RevId: 821726573

Author: vertex-sdk-bot

vertexai/_genai/agent_engines.py

@@ -1076,6 +1076,11 @@ def _create_config(
                 _agent_engines_utils._get_agent_framework(agent=agent)
             )
             update_masks.append("spec.agent_framework")
+
+            agent_engine_spec["agent_card"] = getattr(
+                getattr(agent, "agent_card", None), "model_dump_json", lambda: None
+            )()
+
             config["spec"] = agent_engine_spec
         if update_masks and mode == "update":
             config["update_mask"] = ",".join(update_masks)

vertexai/_genai/types.py

@@ -4925,6 +4925,10 @@ class ReasoningEngineSpec(_common.BaseModel):
         default=None,
         description="""Optional. The service account that the Reasoning Engine artifact runs as. It should have "roles/storage.objectViewer" for reading the user project's Cloud Storage and "roles/aiplatform.user" for using Vertex extensions. If not specified, the Vertex AI Reasoning Engine Service Agent in the project will be used.""",
     )
+    agent_card: Optional[str] = Field(
+        default=None,
+        description="""Optional. The A2A agent card that describes the agent's capabilities.""",
+    )
 
 
 class ReasoningEngineSpecDict(TypedDict, total=False):
@@ -4945,6 +4949,11 @@ class ReasoningEngineSpecDict(TypedDict, total=False):
     service_account: Optional[str]
     """Optional. The service account that the Reasoning Engine artifact runs as. It should have "roles/storage.objectViewer" for reading the user project's Cloud Storage and "roles/aiplatform.user" for using Vertex extensions. If not specified, the Vertex AI Reasoning Engine Service Agent in the project will be used."""
 
+    agent_card: Optional[str] = Field(
+        default=None,
+        description="""Optional. The A2A agent card that describes the agent's capabilities.""",
+    )
+
 
 ReasoningEngineSpecOrDict = Union[ReasoningEngineSpec, ReasoningEngineSpecDict]