تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

القيود

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

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

قبل البدء

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

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

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

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

(اختياري) ربط الأذونات بالإعدادات والاستهدافات

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

لضبط إعدادات المشرف في Gemini Code Assist Standard وEnterprise باستخدام Gemini for Google Cloud API، عليك أولاً إنشاء الإعدادات، ثم إنشاء عمليات ربط "لربط" هذه الإعدادات والاستهدافات (مثل المثيل أو الموضوع أو المشاريع) لمنتجات معيّنة (مثل Gemini Cloud Assist أو Gemini Code Assist).

تكون جميع الأذونات لإنشاء الإعدادات وتعديلها على مستوى المشروع.

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

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

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

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

تفعيل التسجيل في Gemini Code Assist

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

وحدة التحكّم

تأكَّد من تفعيل واجهة برمجة التطبيقات Cloud Logging في المشروع.
تأكَّد من أنّ لديك أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:
- 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
في وحدة تحكّم واجهة برمجة التطبيقات، انتقِل إلى صفحة مشرف Gemini.

الانتقال إلى Gemini لخدمة Google Cloud

يتم تحميل صفحة Gemini في Google Cloud.
انقر على الإعدادات في قائمة التنقّل اليمنى.

يتم تحميل صفحة الإعدادات.
(اختياري) انقر على تسجيل البيانات الوصفية لميزة Code Assist لتسجيل البيانات الوصفية التي أنشأها مستخدمو Gemini Code Assist Standard وEnterprise في المشروع.
(اختياري) انقر على تسجيل طلبات Code Assist وردود المستخدمين لتسجيل الطلبات والردود التي ينشئها مستخدمو Gemini Code Assist Standard وEnterprise في المشروع.
انقر على حفظ التغييرات.

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

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

تأكَّد من تفعيل واجهة برمجة تطبيقات Cloud Logging في المشروع.
تأكَّد من أنّ لديك أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:
- 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
أنشئ الإعداد والقيمة الخاصة به:
1. الحصول على الرمز المميّز:
```
TOKEN=$(gcloud auth print-access-token)
```

فعِّل سجلّات metadata في Gemini Code Assist Standard وEnterprise.

شغِّل الأمر التالي لإنشاء الإعداد:

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"

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

CONTAINER_PROJECT_NAME: أدخِل رقم تعريف المشروع الرئيسي.
SETTING_ID: أدخِل اسمًا فريدًا للإعداد، مثل gcalm1 لـ Gemini Code Assist log metadata.

إذا كان الأمر ناجحًا، سيعرض نص الاستجابة قيمة log_metadata التي تم ضبطها على 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
}

شغِّل الأمر التالي لإنشاء عملية ربط إعدادات ملف loggen لملف ملف loggen metadata 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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

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

TARGET_PROJECT_NAME: أدخِل المشروع المستهدَف الذي يجب تطبيق الإعداد عليه.
SETTING_ID: استخدِم SETTING_ID نفسه عند إنشاء الإعداد، ولكن أضِف إليه b1. على سبيل المثال، استخدِم gcalmb1 بدلاً من Gemini Code Assist log metadata.

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

{
  "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
}

فعِّل سجلّات مستخدمي Gemini Code Assist Standard وEnterprise.

شغِّل الأمر التالي لإنشاء الإعداد:

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"

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

CONTAINER_PROJECT_NAME: أدخِل رقم تعريف المشروع الرئيسي.
SETTING_ID: أدخِل اسمًا فريدًا للإعداد، مثل gcapar1 لـ Gemini Code Assist prompts and responses.

إذا كان الأمر ناجحًا، سيعرض نص الاستجابة قيمة log_prompts_and_responses التي تم ضبطها على 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
}

شغِّل الأمر التالي لإنشاء عملية ربط إعدادات سجلّات مستخدمي Gemini Code Assist Standard وEnterprise:

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"

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

TARGET_PROJECT_NAME: أدخِل المشروع المستهدَف الذي يجب تطبيق الإعداد عليه.
SETTING_ID: استخدِم SETTING_ID نفسه عند إنشاء الإعداد، ولكن أضِف إليه b1. على سبيل المثال، استخدِم gcaparb1 بدلاً من Gemini Code Assist prompts and responses.

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

{
  "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
}

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

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

وحدة التحكّم

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

الانتقال إلى Gemini لخدمة Google Cloud

يتم تحميل صفحة Gemini في Google Cloud.
انقر على الإعدادات في قائمة التنقّل اليمنى.

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

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

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

تأكَّد من أنّ لديك أذونات إدارة الهوية وإمكانية الوصول التالية في المشروع الذي يملك الاشتراك:
- 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
أنشئ الإعداد والقيمة الخاصة به:
1. الحصول على الرمز المميّز:
```
TOKEN=$(gcloud auth print-access-token)
```
شغِّل الأمر التالي لإيقاف إعدادات سجلات البيانات الوصفية في Gemini Code Assist Standard وEnterprise:
```
  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"
```
غيِّر القيم في السلسلة على الشكل التالي:
- CONTAINER_PROJECT_NAME: أدخِل رقم تعريف المشروع الرئيسي.
- SETTING_ID: أدخِل اسم الإعداد الحالي، مثل gcalm1 لـ Gemini Code Assist log metadata.
  
  إذا كان الأمر ناجحًا، سيعرض نص الاستجابة قيمة log_metadata التي تم ضبطها على 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
}
```
شغِّل الأمر التالي لإيقاف إعدادات سجلات مستخدمي Gemini Code Assist Standard وEnterprise:
```
  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"
```
غيِّر القيم في السلسلة على الشكل التالي:
- CONTAINER_PROJECT_NAME: أدخِل رقم تعريف المشروع الرئيسي.
- SETTING_ID: أدخِل اسم الإعداد الحالي، مثل gcapar1 لـ Gemini Code Assist prompts and responses.
  
  إذا كان الأمر ناجحًا، سيعرض نص الاستجابة قيمة log_prompts_and_responses التي تم ضبطها على 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
}
```

ضبط إعدادات تسجيل Gemini Code Assist Standard وEnterprise تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

القيود

قبل البدء

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

(اختياري) ربط الأذونات بالإعدادات والاستهدافات

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

تفعيل التسجيل في Gemini Code Assist

وحدة التحكّم

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

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

وحدة التحكّم

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

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

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