Interface AgentDiscoveryClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.
Agent Discovery lets you search public records for AI agents, tools, skills, and other resources that their publishers have made discoverable.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic AgentDiscoveryClientBuilderbuilder()Create a builder that can be used to configure and create aAgentDiscoveryClient.static AgentDiscoveryClientcreate()Create aAgentDiscoveryClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default SearchPublicRecordsResponsesearchPublicRecords(Consumer<SearchPublicRecordsRequest.Builder> searchPublicRecordsRequest) Search public agent records across the authoritative + crawler indexes.default SearchPublicRecordsResponsesearchPublicRecords(SearchPublicRecordsRequest searchPublicRecordsRequest) Search public agent records across the authoritative + crawler indexes.default SearchPublicRecordsIterablesearchPublicRecordsPaginator(Consumer<SearchPublicRecordsRequest.Builder> searchPublicRecordsRequest) This is a variant ofsearchPublicRecords(software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsRequest)operation.default SearchPublicRecordsIterablesearchPublicRecordsPaginator(SearchPublicRecordsRequest searchPublicRecordsRequest) This is a variant ofsearchPublicRecords(software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsRequest)operation.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadataMethods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
searchPublicRecords
default SearchPublicRecordsResponse searchPublicRecords(SearchPublicRecordsRequest searchPublicRecordsRequest) throws ThrottlingException, ValidationException, InternalServerException, AwsServiceException, SdkClientException, AgentDiscoveryException Search public agent records across the authoritative + crawler indexes. Hybrid keyword + neural ranking, merged and fused (weighted RRF), with filters, org governance policy, and descriptor-visibility enforcement applied server-side. Public, authenticated (D-1).
- Parameters:
searchPublicRecordsRequest-- Returns:
- Result of the SearchPublicRecords operation returned by the service.
- See Also:
-
searchPublicRecords
default SearchPublicRecordsResponse searchPublicRecords(Consumer<SearchPublicRecordsRequest.Builder> searchPublicRecordsRequest) throws ThrottlingException, ValidationException, InternalServerException, AwsServiceException, SdkClientException, AgentDiscoveryException Search public agent records across the authoritative + crawler indexes. Hybrid keyword + neural ranking, merged and fused (weighted RRF), with filters, org governance policy, and descriptor-visibility enforcement applied server-side. Public, authenticated (D-1).
This is a convenience which creates an instance of the
SearchPublicRecordsRequest.Builderavoiding the need to create one manually viaSearchPublicRecordsRequest.builder()- Parameters:
searchPublicRecordsRequest- AConsumerthat will call methods onSearchPublicRecordsRequest.Builderto create a request.- Returns:
- Result of the SearchPublicRecords operation returned by the service.
- See Also:
-
searchPublicRecordsPaginator
default SearchPublicRecordsIterable searchPublicRecordsPaginator(SearchPublicRecordsRequest searchPublicRecordsRequest) throws ThrottlingException, ValidationException, InternalServerException, AwsServiceException, SdkClientException, AgentDiscoveryException This is a variant of
searchPublicRecords(software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.agentdiscovery.paginators.SearchPublicRecordsIterable responses = client.searchPublicRecordsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.agentdiscovery.paginators.SearchPublicRecordsIterable responses = client .searchPublicRecordsPaginator(request); for (software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.agentdiscovery.paginators.SearchPublicRecordsIterable responses = client.searchPublicRecordsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchPublicRecords(software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsRequest)operation.- Parameters:
searchPublicRecordsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
searchPublicRecordsPaginator
default SearchPublicRecordsIterable searchPublicRecordsPaginator(Consumer<SearchPublicRecordsRequest.Builder> searchPublicRecordsRequest) throws ThrottlingException, ValidationException, InternalServerException, AwsServiceException, SdkClientException, AgentDiscoveryException This is a variant of
searchPublicRecords(software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.agentdiscovery.paginators.SearchPublicRecordsIterable responses = client.searchPublicRecordsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.agentdiscovery.paginators.SearchPublicRecordsIterable responses = client .searchPublicRecordsPaginator(request); for (software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.agentdiscovery.paginators.SearchPublicRecordsIterable responses = client.searchPublicRecordsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchPublicRecords(software.amazon.awssdk.services.agentdiscovery.model.SearchPublicRecordsRequest)operation.
This is a convenience which creates an instance of the
SearchPublicRecordsRequest.Builderavoiding the need to create one manually viaSearchPublicRecordsRequest.builder()- Parameters:
searchPublicRecordsRequest- AConsumerthat will call methods onSearchPublicRecordsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
create
Create aAgentDiscoveryClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aAgentDiscoveryClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-