빠른 시작: 에이전트 등록

Agent Registry에 에이전트를 등록하면 격리된 구성요소를 AI 생태계의 검색 가능한 부분으로 전환할 수 있습니다. 에이전트의 A2A 기술을 게시하면 조직의 다른 개발자와 조정자 에이전트가 내 작업을 찾고 재사용하는 데 도움이 됩니다.

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

시작하기 전에

  1. Agent Registry 설정
  2. Agent Registry가 사용 설정된 거버넌스 프로젝트의 프로젝트 ID를 가져옵니다.

필요한 역할

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

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

모의 에이전트 등록

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

에이전트를 등록하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 에이전트 레지스트리로 이동합니다.

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

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

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

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

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

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

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

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

  7. 다음 샘플 에이전트 카드 콘텐츠를 붙여넣습니다.

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. 저장을 클릭합니다.

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

등록 확인

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

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

삭제

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

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

다음 단계