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

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

القيود

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

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

قبل البدء

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

(اختياري) منح أذونات "إدارة الهوية وإمكانية الوصول"

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

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

ضبط إعدادات تسجيل 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. تأكَّد من توفّر أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:

    • 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. في API 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. تأكَّد من توفّر أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:

    • 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. تأكَّد من توفّر أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:

    • 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. في API 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. تأكَّد من توفّر أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:

    • 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
}

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