에이전트 및 도구 검색

에이전트형 생태계가 성장함에 따라 적합한 에이전트 또는 도구를 찾는 것이 중요해집니다. 에이전트 레지스트리는 에이전트 및 모델 컨텍스트 프로토콜 (MCP) 서버에서 고급 키워드 및 프리픽스 검색을 실행할 수 있는 검색 기능을 제공합니다.

이 문서에서는 환경 내에서 기능을 검색하기 위한 검색어를 구성하는 방법을 설명합니다.

시작하기 전에

에이전트 레지스트리에서 에이전트 또는 도구를 검색하기 전에, 에이전트 또는 MCP 서버를 등록하세요. 이러한 작업을 실행하려면 프로젝트 ID 도 필요합니다.

이 문서의 gcloud CLI 명령어를 사용하려면 Google Cloud CLI 환경을 설정해야 합니다.

필요한 역할

에이전트 레지스트리에서 에이전트 및 도구를 검색하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한에이전트 레지스트리 API 뷰어 (roles/agentregistry.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

키워드 검색을 실행하여 에이전트의 기술 또는 MCP 서버의 도구와 같은 기능 전반에서 특정 용어와 일치하는 리소스를 찾을 수 있습니다. 레지스트리에서 이러한 기능이 구성되는 방식을 이해하려면 JSON 스키마를 참조하세요. 검색 가능한 필드의 전체 목록은 API 참조를 확인하세요.

키워드로 검색하려면 --search-string 플래그를 제공합니다. 이 매개변수는 자유 형식 쿼리를 허용하고 논리 연산자(AND, OR, NOT)를 지원합니다.

예를 들어 항공편 예약을 처리할 수 있는 에이전트를 검색합니다.

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="flight OR booking"

제공하는 특정 도구 또는 설명을 기반으로 MCP 서버를 검색할 수도 있습니다. 예를 들어 데이터베이스 도구를 제공하는 MCP 서버를 검색합니다.

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="database"

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다.
  • REGION: 레지스트리 리전입니다.

프리픽스 검색은 지연 시간이 매우 최적화되어 있으므로 사용자가 입력할 때 애플리케이션이 관련 에이전트와 도구를 동적으로 가져올 수 있습니다.

오케스트레이터 인터페이스 또는 자동 완성 기능을 빌드하는 경우 에이전트 레지스트리에서 프리픽스 검색을 실행하여 쿼리 문자열의 시작 부분과 일치하는 결과를 가져올 수 있습니다. 프리픽스 검색은 서픽스 와일드 카드 기호(*)를 사용하여 단어의 시작 부분을 찾습니다.

예를 들어 표시 이름이 Best_A2A_*와 같은 특정 프리픽스로 시작하는 에이전트를 검색합니다.

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Best_A2A_*"

마찬가지로 표시 이름이 Prod_Server_*와 같은 특정 프리픽스로 시작하는 MCP 서버를 검색할 수 있습니다.

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Prod_Server_*"

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다.
  • REGION: 레지스트리 리전입니다.