agent_cards

Creates, updates, deletes, gets or lists an agent_cards resource.

Overview

Name	agent_cards
Type	Resource
Id	aws.bedrock_agentcore.agent_cards

Fields

The following fields are returned by SELECT queries:

get_agent_card

Name	Datatype	Description
agent_card	object	An agent card document that contains metadata and capabilities for an AgentCore Runtime agent.
runtime_session_id	string	The ID of the session associated with the AgentCore Runtime agent. (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9-_]*</code>)
status_code	integer	The status code of the request.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_agent_card	select	agent_runtime_arn, region	X-Amzn-Bedrock-AgentCore-Runtime-Session-Id, qualifier	Retrieves the A2A agent card associated with an AgentCore Runtime agent.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
agent_runtime_arn	string	The ARN of the AgentCore Runtime agent for which you want to get the A2A agent card.
region	string	AWS region (default: us-east-1)
X-Amzn-Bedrock-AgentCore-Runtime-Session-Id	string	The session ID that the AgentCore Runtime agent is using.
qualifier	string	Optional qualifier to specify an agent alias, such as prodcode> or dev. If you don't provide a value, the DEFAULT alias is used.

SELECT examples

get_agent_card

Retrieves the A2A agent card associated with an AgentCore Runtime agent.

SELECT
agent_card,
runtime_session_id,
status_code
FROM aws.bedrock_agentcore.agent_cards
WHERE agent_runtime_arn = '{{ agent_runtime_arn }}' -- required
AND region = '{{ region }}' -- required
AND `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id` = '{{ X-Amzn-Bedrock-AgentCore-Runtime-Session-Id }}'
AND qualifier = '{{ qualifier }}'
;