Google Cloud 콘솔에서 에이전트 공유

이 페이지에서는 조직의 사용자와 에이전트를 공유하는 방법을 설명합니다. 관리자는 사용 가능한 에이전트 (Google에서 만든 에이전트, 직원들이 만든 에이전트, 맞춤 에이전트)를 개별 사용자, 그룹, 직원 ID 풀 그룹 또는 조직의 모든 사용자와 공유할 수 있습니다. Gemini Enterprise에서 사용할 수 있는 다양한 유형 의 에이전트에 대한 자세한 내용은 에이전트 개요를 참고하세요.

참고: 직원들이 만든 에이전트를 공유하려면 Gemini Enterprise 웹 앱에서 Agent Designer를 사용하여 만든 에이전트가 하나 이상 있어야 합니다. Agent Designer를 사용하여 에이전트를 만드는 방법에 대한 자세한 내용은 Agent Designer를 사용하여 에이전트 만들기를 참고하세요.

시작하기 전에

에이전트를 공유하려면 다음 요구사항을 충족해야 합니다.

1. 사전에 Gemini Enterprise 웹 앱이 존재해야 합니다. 새 앱을 만들려면 앱 만들기를 참조하세요.

2. 맞춤 에이전트를 공유하려면 다음 옵션 중 하나를 사용하여 Gemini Enterprise에 맞춤 에이전트를 등록하거나 추가해야 합니다.

   • A2A 에이전트 등록 및 관리
   • Vertex AI Agent Engine에서 호스팅되는 ADK 에이전트 등록 및 관리
   • Google Cloud Marketplace에서 A2A 에이전트 추가 및 관리
   • Dialogflow 에이전트 등록 및 관리

에이전트 공유

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

콘솔

1. 콘솔에서 Gemini Enterprise 페이지로 이동합니다. Google Cloud

Gemini Enterprise로 이동

1. 프로젝트를 선택합니다.

2. 이름 열에서 앱을 클릭합니다. 그러면 탐색 메뉴가 업데이트됩니다.

3. 탐색 메뉴에서 에이전트 를 클릭합니다.

4. 공유하려는 에이전트의 표시 이름 을 클릭합니다.

5. 사용자 권한 탭을 클릭하면 권한이 있는 사용자 페이지가 표시됩니다.

6. 사용자 추가 를 클릭합니다. 에이전트에 사용자 권한 역할 추가 대화상자가 표시됩니다.

7. 권한 세부정보를 구성합니다.

   1. 구성원 유형 섹션에서 다음 옵션 중 하나를 선택합니다.

      • 사용자: 개별 최종 사용자입니다. 이 구성원 유형이 작동하려면 올바른 IAM 역할을 포함해야 합니다. 자세한 내용은 IAM 역할 및 권한을 참고하세요.

      • 그룹: 최종 사용자 모음입니다. 이 구성원 유형이 작동하려면 올바른 IAM 역할을 포함해야 합니다. 자세한 내용은 IAM 역할 및 권한을 참고하세요.

      • 주 구성원: 직원 ID 풀 그룹의 단일 ID로, 에서 관리하지 않는 외부 그룹을 포함합니다. Google

      • 직원 ID 풀: 직원 ID 풀의 모든 ID입니다.

      • 모든 사용자: 조직의 모든 사용자입니다.

   2. 고유한 구성원 식별자를 입력하고 역할을 선택합니다.

      구성원 유형	설명
      사용자	구성원 입력란에 이메일 주소를 입력합니다. 역할 할당 입력란에서 역할을 선택합니다.
      그룹	구성원 입력란에 이메일 주소를 입력합니다. 역할 할당 입력란에서 역할을 선택합니다.
      주 구성원	WIF 내의 단일 ID입니다.
      직원 ID 풀	구성원 입력란에 주 구성원 식별자 를 입력합니다. 역할 할당 입력란에서 역할을 선택합니다. 주 구성원 집합의 예시는 주 구성원 집합을 참고하세요.
      모든 사용자	역할 할당 입력란에서 역할을 선택합니다.

8. 저장 을 클릭합니다.

주 구성원 집합

다음은 직원 ID 풀 구성원 유형에 지정할 수 있는 주 구성원 집합의 예시입니다.

주 구성원 집합	설명
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	WIF 내의 단일 ID입니다.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	그룹의 모든 직원 ID입니다.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	특정 속성 값을 가진 모든 직원 ID입니다.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	직원 ID 풀의 모든 ID입니다.

다음 자리표시자를 코드 샘플의 값으로 바꿉니다.

• PROJECT_NUMBER: 특정 프로젝트를 식별하기 위해 리소스 경로에 사용되는 번호입니다. Google Cloud
• GROUP_ID: 외부 ID 공급업체 (IdP)의 특정 그룹 식별자로, 해당 그룹의 모든 구성원에게 액세스 권한을 부여할 수 있습니다.
• POOL_ID: 에서 만드는 직원 ID 풀의 고유 ID입니다 Google Cloud.
• ATTRIBUTE_NAME: 외부 ID 공급업체 (IdP)에서 매핑한 커스텀 속성의 사용자 정의 이름입니다.
• ATTRIBUTE_VALUE: 액세스를 제한하는 데 사용되는 ATTRIBUTE_NAME의 특정 값입니다.