Gemini Cloud Assist의 그라운딩 구성

콘솔

1. Google Cloud 콘솔에서 Gemini Cloud Assist로 이동한 다음 설정을 클릭합니다.

   설정으로 이동

2. 사용할 그라운딩 옵션을 선택합니다.

3. 저장을 클릭합니다.

API

API를 사용하여 Gemini Cloud Assist의 그라운딩을 구성하려면 geminiGcpEnablementSettings.create 메서드를 사용하여 그라운딩 유형을 정의하는 geminiGcpEnablementSettings 리소스를 만듭니다. 그런 다음 연결된 settingBindings.create 메서드를 사용하여 설정을 적용하여 설정을 프로젝트에 바인딩합니다.

1. 설정 및 설정별 값을 만듭니다.

   1. 인증 토큰을 가져옵니다.

      TOKEN=$(gcloud auth print-access-token)
      

      인증에 대한 자세한 내용은 REST 사용을 위한 인증을 참조하세요.

   2. 다음 명령어를 실행하여 설정을 만듭니다.

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "webGroundingType": GROUNDING_TYPE
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"
      

      다음을 바꿉니다.

      • CONTAINER_PROJECT: 설정 데이터를 저장하는 프로젝트의 프로젝트 ID입니다.
      • GROUNDING_TYPE: 그라운딩 유형으로, GROUNDING_WITH_GOOGLE_SEARCH 또는 WEB_GROUNDING_FOR_ENTERPRISE입니다.
      • GROUNDING_SETTING_ID: 이 특정 설정 데이터를 식별하는 고유한 이름입니다(예: gt1).

      명령어가 성공하면 webGroundingType이 선택한 값으로 설정된 응답 본문이 반환됩니다.

      {
        "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "webGroundingType": GROUNDING_TYPE
      }
      

2. 설정 바인딩을 만듭니다.

     curl -X POST \
       -H "Authorization: Bearer $TOKEN" \
       -H 'Content-Type: application/json' \
       -d '{
         "target": "projects/TARGET_PROJECT",
         "product": "GEMINI_CLOUD_ASSIST"
         }' \
       "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"
   

   다음을 바꿉니다.

   • TARGET_PROJECT: 설정을 적용할 프로젝트의 프로젝트 ID입니다. 일반적으로 타겟 프로젝트와 컨테이너 프로젝트는 동일합니다.
   • CONTAINER_PROJECT: 설정 데이터를 저장하는 프로젝트의 프로젝트 ID입니다.
   • GROUNDING_SETTING_ID: 설정을 만들 때 지정한 GROUNDING_SETTING_ID입니다.
   • GROUNDING_BINDING_ID: 이 특정 설정 바인딩 리소스를 식별하는 고유 ID입니다(예: b1).

   명령어가 성공하면 다음 형식의 작업 메타데이터가 반환됩니다.

   {
     "name": "projects/<var>CONTAINER_PROJECT</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
       "createTime": "2025-01-23T15:27:50.076075570Z",
       "target": "projects/<var>TARGET_PROJECT</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }