Agent Registry에서 엔드포인트는 일반적으로 에이전트가 액세스하는 REST API인 대상 URL을 나타냅니다. 이러한 대상을 Agent Registry 내에서 관리형 에이전트 구성요소로 등록하면 에이전트 Fleet이 연결할 수 있는 외부 엔드포인트를 중앙에서 관리할 수 있습니다.
이 문서에서는 레지스트리에 외부 엔드포인트를 명시적으로 등록하는 방법을 설명합니다.
시작하기 전에
시작하기 전에 Agent Registry를 설정합니다. 이러한 작업을 수행하려면 프로젝트 ID가 필요합니다.
이 문서의 gcloud CLI 명령어를 사용하려면 Google Cloud CLI 환경을 설정해야 합니다.
필요한 역할
Agent Registry에 엔드포인트를 등록하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Agent Registry API 편집자 (roles/agentregistry.editor) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
엔드포인트 등록
엔드포인트는 커스텀 외부 대상이므로 수동 등록을 사용하여 Agent Registry에 추가합니다.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
엔드포인트 탭을 선택합니다.
엔드포인트 추가 를 클릭합니다.
엔드포인트 세부정보 패널에서 표시 이름, 설명, 지리적 리전, 도착 URL을 입력합니다.
선택적으로 이 패널에서 연결 테스트 를 클릭하여 도착 URL에 대한 연결을 테스트합니다.
저장 을 클릭합니다.
gcloud
endpoint-spec-type이 no-spec인 Service 리소스를 만듭니다.
엔드포인트를 등록하고 인터페이스 연결 세부정보를 정의합니다.
gcloud alpha agent-registry services create ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--endpoint-spec-type=no-spec \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
다음을 바꿉니다.
ENDPOINT_NAME: 엔드포인트에 지정할 이름(예:my-external-api)PROJECT_ID: 프로젝트 ID입니다.REGION: 레지스트리 리전입니다.DISPLAY_NAME: 사람이 읽을 수 있는 엔드포인트 이름입니다.ENDPOINT_URL: 대상 URL(예:https://api.example.com/v1/data)PROTOCOL: 인터페이스의 프로토콜 바인딩입니다. 유효한 값은HTTP_JSON,GRPC또는JSONRPC입니다.
Service 리소스가 생성되면 Agent Registry는 에이전트와
오케스트레이터가 검색하고 사용할 수 있는 소비자 측에 읽기 전용 Endpoint 리소스를 자동으로
생성합니다.