이 페이지에서는 Gemini Enterprise에 등록한 에이전트 간 (A2A), 에이전트 개발 키트 (ADK), Dialogflow 에이전트와 Google Cloud Marketplace에서 추가한 에이전트를 공유하는 방법을 설명합니다. 사용자가 Gemini Enterprise 웹 앱에서 이러한 에이전트에 액세스하는 방법을 알 수 있도록 Google Cloud Marketplace에서 추가한 A2A 에이전트도 설명합니다.
시작하기 전에
에이전트를 공유하려면 다음 요구사항을 충족해야 합니다.
기존 Gemini Enterprise 웹 앱이 있어야 합니다. 새 앱을 만들려면 앱 만들기를 참고하세요.
다음 옵션 중 하나를 사용하여 Gemini Enterprise에 맞춤 에이전트를 등록하거나 추가해야 합니다.
사용자와 맞춤 에이전트 공유
Gemini Enterprise에 등록된 맞춤 에이전트에 액세스할 수 있는 사용자를 제어할 수 있습니다.
에이전트를 공유하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.
프로젝트를 선택합니다.
이름 열에서 앱을 클릭합니다. 그러면 탐색 메뉴가 업데이트됩니다.
탐색 메뉴에서 상담사를 클릭합니다.
공유하려는 상담사의 표시 이름을 클릭합니다.
사용자 권한 탭을 클릭하면 권한이 부여된 사용자 페이지가 표시됩니다.
사용자 추가를 클릭합니다. 에이전트에 사용자 권한 역할 추가 대화상자가 표시됩니다.
권한 세부정보를 구성합니다.
회원 유형 섹션에서 다음 옵션 중 하나를 선택합니다.
사용자: 개별 최종 사용자입니다. 이 구성원 유형이 작동하려면 올바른 IAM 역할을 포함해야 합니다. 자세한 내용은 IAM 역할 및 권한을 참고하세요.
그룹: 최종 사용자 모음입니다. 이 구성원 유형이 작동하려면 올바른 IAM 역할을 포함해야 합니다. 자세한 내용은 IAM 역할 및 권한을 참고하세요.
주 구성원 집합: 워크로드 아이덴티티 풀 그룹의 모든 ID입니다. 여기에는 Google에서 관리하지 않는 외부 그룹이 포함됩니다.
모든 사용자: 조직의 모든 사용자입니다.
고유한 회원 식별자를 입력하고 역할을 선택합니다.
회원 유형 설명 사용자 구성원 필드에 이메일 주소를 입력합니다.
역할 할당 필드에서 역할을 선택합니다.그룹 구성원 필드에 이메일 주소를 입력합니다.
역할 할당 필드에서 역할을 선택합니다.직원 ID 풀 구성원 필드에 주 구성원 식별자를 입력합니다.
역할 할당 필드에서 역할을 선택합니다.
주 구성원 집합의 예는 주 구성원 집합을 참고하세요.모든 사용자 역할 할당 필드에서 역할을 선택합니다.
저장을 클릭합니다.
주 구성원 집합
다음은 직원 ID 풀 구성원 유형에 지정할 수 있는 주 구성원 집합의 예입니다.
| 주 구성원 집합 | 설명 |
|---|---|
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID |
그룹의 모든 직원 ID입니다. |
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE |
특정 속성 값을 가진 모든 직원 ID |
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/* |
직원 ID 풀의 모든 ID입니다. |
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP_ID |
워크로드 아이덴티티 풀 그룹입니다. |
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE |
특정 속성이 있는 워크로드 아이덴티티 풀의 모든 ID입니다. |
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/* |
워크로드 아이덴티티 풀의 모든 ID입니다. |
다음 자리표시자를 코드 샘플의 값으로 바꿉니다.
PROJECT_NUMBER: 리소스 경로에서 특정 Google Cloud 프로젝트를 식별하는 데 사용되는 번호입니다.GROUP_ID: 외부 ID 공급업체 (IdP)의 특정 그룹 식별자로, 해당 그룹의 모든 구성원에게 액세스 권한을 부여할 수 있습니다.POOL_ID: Google Cloud에서 만드는 워크로드 아이덴티티 풀의 고유 ID입니다.ATTRIBUTE_NAME: 외부 ID 공급자 (IdP)에서 매핑한 맞춤 속성의 사용자 정의 이름입니다.ATTRIBUTE_VALUE: 액세스를 제한하는 데 사용되는ATTRIBUTE_NAME의 특정 값입니다.