Konfigurowanie rejestrowania Gemini Code Assist Standard i Enterprise

Ten dokument wyjaśnia, jak skonfigurować rejestrowanie standardowych i zaawansowanych sesji pomocy w Gemini Code Assist w projekcie za pomocą konsoli interfejsów API Google lub interfejsu API.

Ograniczenia

Rejestrowanie danych dzienników w Gemini Standard i Enterprise w Google Cloud jest ograniczone do interakcji użytkownika z Gemini Code Assist w IDE.

Dodatkowo Gemini for Google Cloud nie rejestruje danych dotyczących Gemini Code Assist Standard i Enterprise, jeśli użytkownik wyłączył telemetrię VS Code.

Zanim zaczniesz

Sprawdź, czy Twój projekt Google Cloud jest połączony z kontem rozliczeniowym.

(Opcjonalnie) Przyznaj uprawnienia

Aby skonfigurować rejestrowanie w Gemini Code Assist Standard i Enterprise, musisz mieć określone uprawnienia Identity and Access Management, które są opisane w kolejnych sekcjach. Upewnij się, że te uprawnienia są dodane do niestandardowych ról uprawnień IAM.

Możesz też przypisać wstępnie zdefiniowaną rolę uprawnień Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin), która obejmuje wszystkie wymagane uprawnienia do pracy ze wszystkimi ustawieniami administratora Gemini for Google Cloud.

(Opcjonalnie) Powiązanie uprawnień z ustawieniami i docelami

Jeśli konfigurujesz ustawienia administratora Gemini Code Assist Standard i Enterprise w konsoli interfejsu API Google, możesz pominąć tę sekcję.

Aby skonfigurować ustawienia administratora Gemini Code Assist Standard i Enterprise za pomocą interfejsu Gemini for Google Cloud API, musisz najpierw utworzyć ustawienia, a następnie utworzyć powiązania, aby „połączyć” te ustawienia i docelowe zasoby (takie jak instancja, temat lub projekty) z konkretnymi usługami (takimi jak Gemini Cloud Assist lub Gemini Code Assist).

Wszystkie uprawnienia do tworzenia i aktualizowania ustawień są przyznawane na poziomie projektu.

Konfigurowanie rejestrowania Gemini Code Assist

W następnych sekcjach znajdziesz instrukcje umożliwiające zbieranie i przechowywanie w Cloud Logging aktywności z usług Gemini Code Assist Standard i Enterprise, w tym:

  • prompty i odpowiedzi Gemini Code Assist w wersji Standard i Enterprise, a także logi, takie jak dane wejściowe użytkownika, informacje kontekstowe i odpowiedzi.

  • logi metadanych Gemini Code Assist Standard i Enterprise, takie jak metadane telemetryczne i wiersze kodu zaakceptowane przez użytkownika.

Więcej informacji o obu typach dzienników znajdziesz w artykule Wyświetlanie dzienników Gemini.

Włączanie rejestrowania danych dla Gemini Code Assist

Wybierz jedną z tych opcji:

Konsola

  1. Upewnij się, że w projekcie włączony jest interfejs Cloud LoggingAPI.

  2. Sprawdź, czy w projekcie, który jest właścicielem subskrypcji, masz te uprawnienia dotyczące zarządzania tożsamością i dostępem:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. W Konsoli interfejsów API otwórz stronę Administracja Gemini.

    Otwórz Gemini dla Google Cloud

    Ładuje się strona Gemini dla Google Cloud.

  4. W menu nawigacyjnym po lewej stronie kliknij Ustawienia.

    Wczytuje się strona Ustawienia.

  5. (Opcjonalnie) Kliknij Logowanie metadanych Code Assist, aby rejestrować metadane wygenerowane przez użytkowników Gemini Code Assist Standard i Enterprise w projekcie.

  6. (Opcjonalnie) Kliknij Logowanie promptów i odpowiedzi Code Assist, aby rejestrować prompty i odpowiedzi wygenerowane przez użytkowników Gemini Code Assist Standard i Enterprise w projekcie.

  7. Kliknij Zapisz zmiany.

Interfejs API

Aby włączyć rejestrowanie w przypadku Gemini Code Assist Standard i Enterprise, użyj metody loggingSetting.

  1. Upewnij się, że w projekcie włączony jest interfejs Cloud Logging API.

  2. Sprawdź, czy w projekcie, który jest właścicielem subskrypcji, masz te uprawnienia dotyczące zarządzania tożsamością i dostępem:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Utwórz ustawienie i wartość dla tego ustawienia:

    1. Uzyskaj token:

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

  4. Włącz dzienniki metadanych Gemini Code Assist Standard i Enterprise.

    1. Aby utworzyć ustawienie, uruchom to polecenie:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "log_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

      Zastąp następujące elementy:

      • CONTAINER_PROJECT_NAME: wpisz identyfikator projektu nadrzędnego.
      • SETTING_ID: wpisz unikalną nazwę ustawienia, np. gcalm1 dla Gemini Code Assist log metadata.

      Jeśli polecenie zadziała, zwróci treść odpowiedzi, w której log_metadata jest ustawiony na true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_metadata": true
}

    2. Aby utworzyć ustawienie powiązania logów metadanych Gemini Code Assist w wersji Standard i Enterprise, uruchom to polecenie:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

    Zastąp następujące elementy:

    • TARGET_PROJECT_NAME: wpisz projekt docelowy, do którego ma zostać zastosowane ustawienie.
    • SETTING_ID: użyj tego samego SETTING_ID, który został użyty podczas tworzenia ustawienia, ale dodaj do niego b1. Na przykład użyj właściwości gcalmb1 zamiast Gemini Code Assist log metadata.

    Jeśli polecenie się powiedzie, zwróci metadane operacji w tym formacie:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</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_NAME</var>/locations/global/loggingSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

  5. Włącz dzienniki użytkowników Gemini Code Assist Standard i Enterprise.

    1. Aby utworzyć ustawienie, uruchom to polecenie:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "log_prompts_and_responses": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

      Zastąp następujące elementy:

      • CONTAINER_PROJECT_NAME: wpisz identyfikator projektu nadrzędnego.
      • SETTING_ID: wpisz unikalną nazwę ustawienia, np. gcapar1 dla Gemini Code Assist prompts and responses.

      Jeśli polecenie zadziała, zwróci treść odpowiedzi, w której log_prompts_and_responses jest ustawiony na true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": true
}

    2. Aby utworzyć ustawienie wiązania logów użytkowników Gemini Code Assist Standard i Enterprise, uruchom to polecenie:

      curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

    Zastąp następujące elementy:

    • TARGET_PROJECT_NAME: wpisz projekt docelowy, do którego ma zostać zastosowane ustawienie.
    • SETTING_ID: użyj tego samego SETTING_ID, który został użyty podczas tworzenia ustawienia, ale dodaj do niego b1. Na przykład użyj właściwości gcaparb1 zamiast Gemini Code Assist prompts and responses.

    Jeśli polecenie zadziała, zwróci metadane operacji w tym formacie:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</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_NAME</var>/locations/global/loggingSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Wyłączanie rejestrowania danych dla Gemini Code Assist

Wybierz jedną z tych opcji:

Konsola

  1. Sprawdź, czy w projekcie, który jest właścicielem subskrypcji, masz te uprawnienia dotyczące zarządzania tożsamością i dostępem:

    • loggingSettings.delete
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsDelete
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  2. W Konsoli interfejsów API otwórz stronę Administracja Gemini.

    Otwórz Gemini dla Google Cloud

    Ładuje się strona Gemini dla Google Cloud.

  3. W menu nawigacyjnym po lewej stronie kliknij Ustawienia.

    Wczytuje się strona Ustawienia.

  4. Kliknij Logowanie metadanych Code Assist, aby wyłączyć rejestrowanie metadanych z użycia Gemini Code Assist Standard i Enterprise w projekcie.

  5. Kliknij Zapisz zmiany.

Interfejs API

Aby włączyć rejestrowanie w przypadku Gemini Code Assist Standard i Enterprise, użyj metody loggingSetting.

  1. Sprawdź, czy w projekcie, który jest właścicielem subskrypcji, masz te uprawnienia dotyczące zarządzania tożsamością i dostępem:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • serviceusage.services.enable

  2. Utwórz ustawienie i wartość dla tego ustawienia:

    1. Uzyskaj token:

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

  3. Aby wyłączyć ustawienie dzienników metadanych Gemini Code Assist w wersji Standard i Enterprise, uruchom to polecenie:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_metadata": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_metadata_id=SETTING_ID"

    Zastąp następujące elementy:

    • CONTAINER_PROJECT_NAME: wpisz identyfikator projektu nadrzędnego.

    • SETTING_ID: wpisz nazwę istniejącego ustawienia, np. gcalm1 dla Gemini Code Assist log metadata.

      Jeśli polecenie zadziała, zwróci treść odpowiedzi, w której log_metadata jest ustawiony na false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_metadata": false
}

  4. Aby wyłączyć ustawienie dzienników użytkowników Gemini Code Assist Standard i Enterprise, uruchom to polecenie:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_prompts_and_responses": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

    Zastąp następujące elementy:

    • CONTAINER_PROJECT_NAME: wpisz identyfikator projektu nadrzędnego.

    • SETTING_ID: wpisz nazwę istniejącego ustawienia, np. gcapar1 dla Gemini Code Assist prompts and responses.

      Jeśli polecenie zadziała, zwróci treść odpowiedzi, w której log_prompts_and_responses jest ustawiony na false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": false
}

Co dalej?