Searches for registry records using semantic, lexical, or hybrid queries¶

Description¶

Searches for registry records using semantic, lexical, or hybrid queries. Returns metadata for matching records ordered by relevance within the specified registry.

Usage¶

bedrockagentcore_search_registry_records(searchQuery, registryIds,
  maxResults, filters)

Arguments¶

searchQuery

[required] The search query to find matching registry records.
registryIds

[required] The list of registry identifiers to search within. Currently, you can specify exactly one registry identifier. You can provide either the full Amazon Web Services Resource Name (ARN) or the 12-character alphanumeric registry ID.
maxResults

The maximum number of records to return in a single call. Valid values are 1 through 20. The default value is 10.
filters

A metadata filter expression to narrow search results. Uses structured JSON operators including field-level operators ($eq, $ne, $in) and logical operators ($and, $or) on filterable fields (name, descriptorType, version). For example, to filter by descriptor type: {"descriptorType": {"$eq": "MCP"}}. To combine filters: {"$and": [{"descriptorType": {"$eq": "MCP"}}, {"name": {"$eq": "my-tool"}}]}.

Value¶

A list with the following syntax:

list(
  registryRecords = list(
    list(
      registryArn = "string",
      recordArn = "string",
      recordId = "string",
      name = "string",
      description = "string",
      descriptorType = "MCP"|"A2A"|"CUSTOM"|"AGENT_SKILLS",
      descriptors = list(
        mcp = list(
          server = list(
            schemaVersion = "string",
            inlineContent = "string"
          ),
          tools = list(
            protocolVersion = "string",
            inlineContent = "string"
          )
        ),
        a2a = list(
          agentCard = list(
            schemaVersion = "string",
            inlineContent = "string"
          )
        ),
        custom = list(
          inlineContent = "string"
        ),
        agentSkills = list(
          skillMd = list(
            inlineContent = "string"
          ),
          skillDefinition = list(
            schemaVersion = "string",
            inlineContent = "string"
          )
        )
      ),
      version = "string",
      status = "DRAFT"|"PENDING_APPROVAL"|"APPROVED"|"REJECTED"|"DEPRECATED",
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      updatedAt = as.POSIXct(
        "2015-01-01"
      )
    )
  )
)

Request syntax¶

svc$search_registry_records(
  searchQuery = "string",
  registryIds = list(
    "string"
  ),
  maxResults = 123,
  filters = list()
)