빠른 시작: 에이전트 등록

에이전트를 등록하면 격리된 워크로드에서 Agent Registry 내에서 검색 가능한 구성요소로 변환됩니다. 에이전트의 기술을 게시하면 조직의 다른 개발자와 오케스트레이터 에이전트가 작업을 찾아 재사용하여 AI 개발을 가속화할 수 있습니다.

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

시작하기 전에

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

필요한 역할

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

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

모의 에이전트 등록

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

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

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

    Agent Registry로 이동

  2. 프로젝트 선택 도구에서 Agent Registry를 설정한 Google Cloud 프로젝트를 선택합니다 .

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

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

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

    • 표시 이름: Mock Travel Agent
    • 설명: A mock agent that plans travel itineraries.
    • 위치: global을 선택합니다.
    • 에이전트 유형: A2A를 선택합니다.

  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. 에이전트 탭의 목록에서 Mock Travel Agent 를 찾습니다.
  2. Mock Travel Agent 를 클릭하여 세부정보를 확인합니다.
  3. BookFlight 및 SearchHotels 기술이 개요 탭에 표시되는지 확인합니다.

정리

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

  1. 에이전트 탭의 목록에서 Mock Travel Agent 를 찾습니다.
  2. Mock Travel Agent 옆에 있는 추가 옵션 메뉴를 클릭하고 삭제를 선택합니다.
  3. 확인 대화상자에서 삭제 를 클릭합니다.

다음 단계

  • 등록된 에이전트를 관리하는 방법을 알아봅니다.
  • 관리형 런타임에 배포된 에이전트를 등록하는 데 권장되는 방법인 자동 등록에 대해 알아봅니다.
  • Agent Registry 주요 개념을 읽어봅니다.