빠른 시작: 에이전트 등록

에이전트를 등록하면 격리된 구성요소에서 에이전트 레지스트리 내 AI 생태계의 검색 가능하고 통합된 부분으로 변환됩니다. 에이전트의 기술을 게시하면 조직의 다른 개발자와 오케스트레이터 에이전트가 내 작업을 찾아 재사용하여 전체 AI 개발을 가속화할 수 있습니다.

이 빠른 시작에서는 Google Cloud 콘솔을 사용하여 에이전트 레지스트리에 모의 에이전트를 수동으로 등록하는 방법을 보여줍니다. 에이전트 레지스트리의 에이전트 등록 메커니즘에 대한 자세한 내용은 에이전트 등록을 참고하세요.

시작하기 전에

시작하기 전에 에이전트 레지스트리를 설정하세요. 이러한 작업을 수행하려면 프로젝트 ID가 필요합니다.

Agent Registry API를 사용 설정합니다.

콘솔

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

API 사용 설정하기

gcloud

프로젝트에서 Agent Registry API를 사용 설정합니다.

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID를 프로젝트 ID로 바꿉니다.

필요한 역할

에이전트 등록부에 에이전트를 등록하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 등록부 API 편집자 (roles/agentregistry.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

모의 에이전트 등록

에이전트 레지스트리를 사용해 보려면 샘플 Agent2Agent (A2A) 에이전트 카드를 붙여넣어 모의 에이전트를 수동으로 등록하면 됩니다.

다음 단계에 따라 에이전트를 등록합니다.

  1. Google Cloud 콘솔에서 Agent Registry로 이동합니다.

    에이전트 레지스트리로 이동

    메시지가 표시되면 사용 설정을 클릭하여 Agent Registry API를 사용 설정합니다.

  2. 프로젝트 선택 도구에서 에이전트 레지스트리를 설정한 Google Cloud 프로젝트를 선택합니다.

  3. 에이전트 탭을 선택합니다.

  4. 에이전트 추가를 클릭합니다.

  5. 에이전트 세부정보 패널에서 다음 세부정보를 입력합니다.

    • 유형: A2A를 선택합니다.
    • 리전: global (전역)을 선택합니다.

  6. JSON 붙여넣기 탭을 선택합니다.

  7. 다음 샘플 상담사 카드 콘텐츠를 복사하여 붙여넣습니다.

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. 저장을 클릭합니다.

Agent Registry는 에이전트 카드를 처리하고 에이전트를 등록합니다.

등록 확인

모의 에이전트가 성공적으로 등록되었는지 확인하려면 다음 단계를 따르세요.

  1. 에이전트 탭에서 목록에 있는 모의 에이전트를 찾습니다.
  2. 에이전트 이름을 클릭하여 세부정보를 확인합니다.
  3. BookFlight 및 SearchHotels 스킬이 Overview 탭에 표시되는지 확인합니다.

삭제

프로젝트에 모의 리소스가 남지 않도록 등록된 에이전트를 삭제하세요.

  1. 에이전트 탭에서 목록에 있는 모의 에이전트를 찾습니다.
  2. 모의 상담사의 작업 열에서 옵션 더보기 메뉴를 클릭하고 삭제를 선택합니다.
  3. 확인 대화상자에서 삭제를 입력하여 작업을 확인합니다.
  4. 삭제를 클릭합니다.

다음 단계