feat: add agent_card to agent engine spec

PiperOrigin-RevId: 821726573

Author: vertex-sdk-bot

vertexai/_genai/agent_engines.py

@@ -1076,6 +1076,14 @@ def _create_config(
                 _agent_engines_utils._get_agent_framework(agent=agent)
             )
             update_masks.append("spec.agent_framework")
+
+            if hasattr(agent, "agent_card"):
+                agent_card = getattr(agent, "agent_card")
+                if agent_card:
+                    agent_engine_spec["agent_card"] = _agent_engines_utils._to_proto(
+                        agent_card
+                    )
+
             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 capabilities.""",
+    )
 
 
 class ReasoningEngineSpecDict(TypedDict, total=False):
@@ -4945,6 +4949,9 @@ 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]
+    """Optional. The A2A Agent Card that describes the agent capabilities."""
+
 
 ReasoningEngineSpecOrDict = Union[ReasoningEngineSpec, ReasoningEngineSpecDict]