Search publicly discoverable records
With public search, AWS-authenticated callers can discover records that organizations have promoted to the public discovery plane. This topic introduces the public search surface, contrasts it with the enterprise search you already use, and explains what public search does and does not return.
Public search is AWS-authenticated. Any AWS-authenticated caller can query it, but a caller must still present valid AWS credentials. Public search is not anonymous and does not allow unauthenticated access.
Enterprise search and public search
AWS Agent Registry has two search surfaces. They answer different questions and return different sets of records.
The following table compares enterprise search and public search.
| Enterprise search (existing) | Public search (new) | |
|---|---|---|
|
Scope |
Records within one organization’s registry. |
Records promoted to the public discovery plane, across organizational boundaries. |
|
Returns |
Records whose status is |
Records that are |
|
Authorization |
The registry’s IAM or JWT authorization configuration. |
AWS-authenticated. Any caller with valid AWS credentials can query it. |
|
API |
|
|
Enterprise search is documented in Search for registry records. The rest of this topic covers public search.
What public search returns
Public search returns only records that are published under a verified Publisher — that is, records that are APPROVED and whose Publisher association is PUBLIC_ASSOCIATION_APPROVED. Records that are approved for internal use only never appear in public search. Promoting a record to public discovery is the only way to make it visible to callers outside your organization. For more information, see Promote a record to public discovery.
Query modes
Public search uses the same hybrid approach as enterprise search. It runs a semantic search and a lexical (keyword) search against the indexed public records and merges the results into a single ranked list.
-
Semantic search finds conceptually related records even when the query words do not appear in the record.
-
Lexical search matches exact names and specific technical terms.
For guidance on writing effective queries and discoverable records, see How record attributes affect search relevance.
Where you can run public search
Because public search is available to any AWS-authenticated caller, you can run it from a range of clients:
-
Agents at runtime, to find verified agents and tools published by other organizations.
-
Integrated development environments and coding assistants.
-
API clients that call
SearchPublicRecordsdirectly.
Regional endpoints
The public discovery data-plane endpoint, agent-discovery.<region>.api.aws, serves public search. This endpoint is distinct from the enterprise registry data-plane endpoint, agent-registry.<region>.api.aws. At general availability, public search is available through the following Regional endpoints:
-
agent-discovery.us-east-1.api.aws -
agent-discovery.eu-west-1.api.aws -
agent-discovery.ap-northeast-1.api.aws
Run a public search
The public search API is available only in the agent-registry namespace.
Console
-
Open the AWS Agent Registry console
. -
In the navigation pane, choose Public discovery.
-
In the search bar, enter your query. The console calls
SearchPublicRecordsand displays ranked results. -
Choose a record to view its public details and the Publisher that it is published under.
AWS CLI
The following AWS CLI command runs a public search.
aws agent-registry search-public-records \ --search-query "travel booking agent" \ --max-results 10 \ --region us-east-1
AWS SDK
The following example runs a public search by using the AWS SDK for Python.
import boto3 client = boto3.client('agent-registry') response = client.search_public_records( searchQuery='travel booking agent', maxResults=10 ) for record in response['records']: print(f"{record['name']} - {record['publisherIdentifier']}")