Agent Registry는 Agent Registry API를 수동으로 호출하지 않고도 지원되는 Google Cloud 런타임에서 호스팅되는 에이전트를 검색하고 등록할 수 있습니다. 런타임에 따라 이 등록 프로세스가 자동으로 진행되거나 배포 중에 선택 구성 단계가 필요합니다.
이 문서에서는 지원되는 런타임에서 에이전트의 검색을 사용 설정하는 방법을 설명합니다. 에이전트를 외부 또는 지원되지 않는 런타임에서 호스팅하는 경우 수동 등록 사용을 참조하세요.
등록 중에 에이전트에서 추출되는 메타데이터 및 기술은 에이전트의 프로토콜에 따라 다릅니다. 자세한 내용은 에이전트 등록을 참조하세요.
Vertex AI Agent Engine에서 에이전트 등록
Vertex AI Agent Engine으로 에이전트를 개발하고 Vertex AI SDK를 사용하여 배포하는 경우 Agent Registry에 자동으로 등록됩니다.
Agent2Agent (A2A) 프로토콜은 에이전트가 기능과 ID를 선언할 수 있는 개방형 표준입니다. 다음 예시에서는 A2A 프로토콜을 구현하는 에이전트를 Vertex AI Agent Engine에 배포하는 방법을 보여줍니다. 자세한 내용은 에이전트 배포를 참조하세요.
# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
agent=my_a2a_agent, # Your defined A2A object
config={
"display_name": "my-support-agent",
"description": "An agent that handles support tickets.",
"requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
},
)
Vertex AI Agent Engine에서 에이전트를 업데이트하거나 삭제하면 Agent Registry가 이러한 변경사항을 자동으로 동기화합니다.
기본 제공 Google 에이전트 등록
Google Workspace 및 Gemini Enterprise 에이전트와 같은 기본 제공 Google 에이전트는 Agent Registry와 자동으로 통합됩니다. 구성 또는 배포 단계를 수행할 필요가 없습니다. 이러한 에이전트는 수집되어 레지스트리 내에서 검색에 사용할 수 있습니다.
GKE에서 에이전트 등록
배포에 apphub.cloud.google.com/functional-type: "AGENT"
주석을 추가하여
Google Kubernetes Engine
에 배포된 에이전트를 등록할 수 있습니다. 이 주석은 배포를 AI 에이전트로 식별하여 Agent Registry가 인트로스펙션 스캔을 실행하도록 합니다.
다음 예시는 GKE 에이전트 배포 매니페스트를 보여줍니다. 자세한 내용은 AI 에이전트 배포 및 오케스트레이션을 참조하세요.
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-agent
annotations:
# Identifies the workload as an AI agent
apphub.cloud.google.com/functional-type: "AGENT"
spec:
selector:
matchLabels:
app: my-agent
template:
metadata:
labels:
app: my-agent
spec:
containers:
- name: server
image: gcr.io/my-project/my-agent:1.0.0
배포가 적용되면 GKE 클러스터는 에이전트에서 메타데이터를 자동으로 가져오려고 시도하고 이를 Agent Registry 데이터 모델에 직접 동기화합니다.
등록 확인
Agent Registry가 에이전트를 성공적으로 등록했는지 확인하려면 에이전트를 나열하세요.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
에이전트 탭을 선택합니다.
이 페이지에는 등록된 모든 에이전트와 이름, 식별자, 설명, 런타임, 위치와 같은 세부정보가 표시됩니다.
에이전트의 위치 또는 런타임 리소스로 목록을 필터링합니다.
- 위치별로 필터링하려면 위치 메뉴를 클릭하고 필터링할 위치를 선택한 후 적용 을 클릭합니다.
- 런타임별로 필터링하려면 런타임 메뉴를 클릭하고 필터링할 런타임을 선택한 후 적용 을 클릭합니다.
이 페이지에는 선택한 조건에 따라 등록된 에이전트의 필터링된 목록이 표시됩니다.
gcloud
에이전트가 여러 개 있거나 자동으로 등록된 에이전트와 같은 특정 에이전트의 등록을 확인하려면 에이전트의 메타데이터로 목록을 필터링하면 됩니다.
이렇게 하려면 Agent Registry용 Google Cloud CLI 환경을 설정 한 후 다음을 실행합니다.
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.REGION: 레지스트리 리전입니다.FILTER_EXPRESSION: 필터링할 에이전트의 필터 표현식입니다. 예를 들어 표시 이름으로 필터링하려면 을 사용하면 됩니다.displayName='DISPLAY_NAME'전역적으로 고유한 식별자 (URN)로 필터링하려면agentId='urn:agent:AGENT_URN'을 사용하면 됩니다.
기본 제공 Google 서비스는 에이전트가 배포된 위치에 따라 URN 형식을 사용합니다. 예를 들어 googleapis.com 게시자를 기준으로 목록을 필터링하여 기본 제공 Google Workspace 에이전트를 검색할 수 있습니다.--filter="agentId:'urn:agent:googleapis.com:*'"