ضبط إعدادات تسجيل Gemini Code Assist Standard وEnterprise

يوضّح هذا المستند كيفية ضبط إعدادات تسجيل Gemini Code Assist Standard وEnterprise لأحد المشاريع باستخدام Google Cloud Console أو إحدى واجهات برمجة التطبيقات.

القيود

يقتصر تسجيل بيانات السجلّ في Gemini Standard وEnterprise في Google Cloud على تفاعلات المستخدمين مع Gemini Code Assist ضمن بيئة التطوير المتكاملة (IDE).

بالإضافة إلى ذلك، لا يسجّل "Gemini في Google Cloud" بيانات لإصدارَي Gemini Code Assist Standard وEnterprise إذا أوقف المستخدم ميزة قياس استخدام VS Code.

قبل البدء

تأكَّد من أنّ مشروعك على Google Cloud مرتبط بحساب فوترة.

التحقّق من أذونات "إدارة الهوية وإمكانية الوصول"

لضبط إعدادات تسجيل Gemini Code Assist Standard وEnterprise، يمكنك منح دور مشرف إعدادات "Gemini في Google Cloud" (roles/cloudaicompanion.settingsAdmin) المحدّد مسبقًا في "إدارة الهوية وإمكانية الوصول"، والذي يتضمّن جميع الأذونات المطلوبة للعمل مع جميع إعدادات المشرف في "Gemini في Google Cloud".

يمكنك بدلاً من ذلك تعديل أي أدوار مخصّصة في خدمة إدارة الهوية وإمكانية الوصول (IAM). يجب أن تتوفّر لديك أذونات محدّدة في "إدارة الهوية وإمكانية الوصول"، وهي موضّحة بالتفصيل في الأقسام التالية.

ضبط إعدادات تسجيل Gemini Code Assist

توفّر الأقسام التالية الخطوات المطلوبة لتفعيل جمع نشاط Gemini Code Assist Standard وEnterprise وتخزينه في Cloud Logging، بما في ذلك:

  • سجلات الطلبات والردود في Gemini Code Assist Standard وEnterprise، مثل إدخالات المستخدمين والمعلومات السياقية والردود

  • سجلات البيانات الوصفية في Gemini Code Assist Standard وEnterprise، مثل البيانات الوصفية الخاصة بقياس الأداء وأسطر الرموز البرمجية التي وافق عليها المستخدم

لمزيد من التفاصيل حول كلا النوعين من السجلات، راجِع عرض سجلّات Gemini.

تفعيل تسجيل الأنشطة في Gemini Code Assist

اختر أحد الخيارات التالية:

وحدة التحكّم

  1. تأكَّد من تفعيل واجهة برمجة التطبيقات Cloud Logging في المشروع.

  2. تأكَّد من توفّر أذونات IAM التالية في المشروع الذي يملك الاشتراك:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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. في Google Cloud Console، انتقِل إلى صفحة مشرف Gemini.

    الانتقال إلى "Gemini في Google Cloud"

    يتم تحميل صفحة Gemini في Google Cloud.

  4. انقر على الإعدادات في قائمة التنقّل اليمنى.

    يتم تحميل صفحة الإعدادات.

  5. (اختياري) انقر على تسجيل بيانات Code Assist الوصفية لتسجيل البيانات الوصفية التي ينشئها مستخدمو Gemini Code Assist Standard وEnterprise في المشروع.

  6. (اختياري) انقر على تسجيل الطلبات والردود في Code Assist لتسجيل الطلبات والردود التي ينشئها مستخدمو Gemini Code Assist Standard وEnterprise في المشروع.

  7. انقر على حفظ التغييرات.

واجهة برمجة التطبيقات

لتفعيل التسجيل في Gemini Code Assist Standard وEnterprise، استخدِم المرجع loggingSettings لتحديد إعدادات التسجيل التي تريدها، واستخدِم المرجع loggingSettings.settingBindings لربط الإعدادات بمشروع:

  1. تأكَّد من تفعيل واجهة برمجة التطبيقات Cloud Logging في المشروع.

  2. تأكَّد من توفّر أذونات IAM التالية في المشروع الذي يملك الاشتراك:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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. أنشئ الإعداد وقيمة خاصة به:

    1. الحصول على الرمز المميّز:

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

  4. فعِّل سجلات Gemini Code Assist Standard وEnterprise. يتم تفعيل سجلّات المستخدمين وسجلّات البيانات الوصفية باستخدام الحقلين log_prompts_and_responses وlog_metadata على التوالي. إذا كنت لا تريد تفعيل أحد الحقول، استبعِده من الطلب.

    1. نفِّذ الأمر التالي لإنشاء الإعداد:

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

      غيِّر القيم في السلسلة على الشكل التالي:

      • استبدِل CONTAINER_PROJECT_NAME برقم تعريف المشروع الذي يتم فيه تخزين المورد المرتبط. هذا هو المشروع الرئيسي الذي يضم عملية الربط.
      • LOGS_SETTING_ID: أدخِل اسمًا فريدًا للإعداد، مثل gcalm.

      في حال نجاح الأمر، سيتم عرض نص استجابة يوضّح أنّ قيمتَي log_prompts_and_responses وlog_metadata تم ضبطهما على true:

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

    2. نفِّذ الأمر التالي لإنشاء ربط إعدادات سجلّات Gemini Code Assist Standard وEnterprise:

      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/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"

    غيِّر القيم في السلسلة على الشكل التالي:

    • TARGET_PROJECT_NAME: أدخِل المشروع المستهدَف الذي يجب ربط عملية الربط به. ويكون هذا المعرّف غالبًا هو نفسه معرّف مشروع الحاوية. ومع ذلك، يمكنك ربط إعداد بمشاريع متعددة حتى لا تحتاج إلى تكرار مورد الإعداد.
    • LOGS_BINDING_ID: استخدِم LOGS_SETTING_ID نفسه عند إنشاء الإعداد، ولكن أضِف إليه b1. على سبيل المثال، استخدِم gcalmb1.

    في حال نجاح الأمر، سيعرض بيانات العملية الوصفية بالتنسيق التالي:

    {
  "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>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

إيقاف تسجيل Gemini Code Assist

اختر أحد الخيارات التالية:

وحدة التحكّم

  1. تأكَّد من توفّر أذونات IAM التالية في المشروع الذي يملك الاشتراك:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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. في Google Cloud Console، انتقِل إلى صفحة مشرف Gemini.

    الانتقال إلى "Gemini في Google Cloud"

    يتم تحميل صفحة Gemini في Google Cloud.

  3. انقر على الإعدادات في قائمة التنقّل اليمنى.

    يتم تحميل صفحة الإعدادات.

  4. انقر على تسجيل بيانات Gemini Code Assist الوصفية لإيقاف تسجيل البيانات الوصفية من استخدام Gemini Code Assist Standard وEnterprise في المشروع.

  5. انقر على حفظ التغييرات.

واجهة برمجة التطبيقات

لإيقاف التسجيل في Gemini Code Assist Standard وEnterprise، استخدِم طريقة loggingSetting.

  1. تأكَّد من توفّر أذونات IAM التالية في المشروع الذي يملك الاشتراك:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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. أنشئ الإعداد وقيمة خاصة به:

    1. الحصول على الرمز المميّز:

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

  3. نفِّذ الأمر التالي لإيقاف إعدادات سجلات Gemini Code Assist Standard وEnterprise:

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

    غيِّر القيم في السلسلة على الشكل التالي:

    • CONTAINER_PROJECT_NAME: أدخِل رقم تعريف المشروع الرئيسي.

    • LOGS_SETTING_ID: أدخِل اسم الإعداد الحالي، مثل gcalm.

      في حال نجاح الأمر، سيتم عرض نص استجابة يوضّح أنّ قيمتَي log_prompts_and_responses وlog_metadata تم ضبطهما على false:

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

الخطوات التالية