에이전트 및 도구 검색

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

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

시작하기 전에

Agent Registry에서 에이전트 또는 도구를 검색하기 전에 에이전트를 등록하거나 MCP 서버를 등록하세요. 이러한 작업을 수행하려면 프로젝트 ID도 필요합니다.

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

필요한 역할

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

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

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

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

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

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

제공하는 특정 도구나 설명에 따라 MCP 서버를 검색할 수도 있습니다. 예를 들어 데이터베이스 도구를 제공하는 MCP 서버를 검색합니다.

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

다음을 바꿉니다.

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

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

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

예를 들어 표시 이름이 특정 접두사(예: Best_A2A_*)로 시작하는 상담사를 검색합니다.

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

마찬가지로 표시 이름이 특정 접두사(예: Prod_Server_*)로 시작하는 MCP 서버를 검색할 수 있습니다.

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

다음을 바꿉니다.

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