feat: add agent_card to agent engine spec

PiperOrigin-RevId: 821726573

Author: vertex-sdk-bot

vertexai/_genai/agent_engines.py

@@ -1228,6 +1228,18 @@ def _create_config(
                     agent=agent,
                 )
             )
+
+            if hasattr(agent, "agent_card"):
+                agent_card = getattr(agent, "agent_card")
+                if agent_card:
+                    try:
+                        agent_engine_spec["agent_card"] = agent_card.model_dump(
+                            exclude_none=True
+                        )
+                    except TypeError as e:
+                        raise ValueError(
+                            f"Failed to convert agent card to dict (serialization error): {e}"
+                        ) from e
             update_masks.append("spec.agent_framework")
 
         if identity_type is not None or service_account is not None:

vertexai/_genai/types/common.py

@@ -4790,6 +4790,10 @@ class ReasoningEngineSpecSourceCodeSpecDict(TypedDict, total=False):
 class ReasoningEngineSpec(_common.BaseModel):
     """The specification of an agent engine."""
 
+    agent_card: Optional[dict[str, Any]] = Field(
+        default=None,
+        description="""Optional. The A2A Agent Card for the agent (if available). It follows the specification at https://a2a-protocol.org/latest/specification/#5-agent-discovery-the-agent-card.""",
+    )
     agent_framework: Optional[str] = Field(
         default=None,
         description="""Optional. The OSS agent framework used to develop the agent. Currently supported values: "google-adk", "langchain", "langgraph", "ag2", "llama-index", "custom".""",
@@ -4827,6 +4831,9 @@ class ReasoningEngineSpec(_common.BaseModel):
 class ReasoningEngineSpecDict(TypedDict, total=False):
     """The specification of an agent engine."""
 
+    agent_card: Optional[dict[str, Any]]
+    """Optional. The A2A Agent Card for the agent (if available). It follows the specification at https://a2a-protocol.org/latest/specification/#5-agent-discovery-the-agent-card."""
+
     agent_framework: Optional[str]
     """Optional. The OSS agent framework used to develop the agent. Currently supported values: "google-adk", "langchain", "langgraph", "ag2", "llama-index", "custom"."""