gcloud agent-registry agents search

NAME
gcloud agent-registry agents search - search agents
SYNOPSIS
gcloud agent-registry agents search --location=LOCATION [--page-size=PAGE_SIZE] [--page-token=PAGE_TOKEN] [--search-string=SEARCH_STRING] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
search agents
EXAMPLES
To search all agents, run: 
gcloud agent-registry agents search
REQUIRED FLAGS
Location resource - Parent value for SearchAgentsRequest. Format: projects/{project}/locations/{location}. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument --location on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

--location=LOCATION
ID of the location or fully qualified identifier for the location.

To set the location attribute:

  • provide the argument --location on the command line.
OPTIONAL FLAGS
--page-size=PAGE_SIZE
The maximum number of agents to return. The service may return fewer than this value. If unspecified, at most 20 agents will be returned. The maximum value is 100; values above 100 will be coerced to 100.
--page-token=PAGE_TOKEN
A page token, received from a previous SearchAgents call.
--search-string=SEARCH_STRING
Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned.

Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol *. See instructions for more details.

Allowed operators: =, :, NOT, AND, OR, and ().

Examples:

  • agentId="urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234" to find the agent with the specified agent ID.
  • name:important to find agents whose name contains important as a word.
  • displayName:works* to find agents whose display name contains words that start with works.
  • skills.tags:test to find agents whose skills tags contain test.
  • planner OR booking to find agents whose metadata contains the words planner or booking.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

API REFERENCE
This command uses the agentregistry/v1 API. The full documentation for this API can be found at: https://docs.cloud.google.com/agent-registry/overview
NOTES
This variant is also available: 
gcloud alpha agent-registry agents search