للحصول على الأذونات التي تحتاجها لاستخدام أدوات Gemini Code Assist،
اطلب من المشرف منحك أدوار "إدارة الهوية وإمكانية الوصول" التالية في
مشروع Google Cloud:
قد تتطلّب الأدوات الفردية أدوارًا إضافية و/أو أذونات إضافية من Google Cloud أو جهات خارجية لاستخدامها أو لاستخدامها في حالات استخدام معيّنة. إذا واجهت أخطاء في الأذونات، يُرجى التواصل مع المشرف للتأكّد من أنّ لديك الأدوار والامتيازات الصحيحة.
التبعيات
تعتمد بعض الأدوات على أدوات أخرى يجب تثبيتها أو تفعيلها قبل استخدامها. في ما يلي بعض
الأمثلة على العناصر التابعة التي قد تكون مطلوبة:
قد تحتاج إلى تثبيت إضافة في بيئة تطوير البرامج المتكاملة.
قد يكون من الضروري تفعيل منتج أو خدمة في مشروعك على Google Cloud.
قد يكون من الضروري إنشاء حساب أو مشروع لخدمة معيّنة.
سيُطلب منك اتّخاذ الإجراءات المطلوبة في المرة الأولى التي تطلب فيها استخدام
أداة في محادثة Gemini Code Assist.
ضبط أداة لاستخدامها في IDE
في بيئة تطوير البرامج المتكاملة (IDE)، انتقِل إلى محادثة Gemini Code Assist واطلب
الحصول على الأداة التي تريد استخدامها باستخدام الرمز @ متبوعًا باسم
الأداة.
على سبيل المثال، يتم إرسال الطلب التالي إلى أداة "مستندات Google":
@GoogleDocs get my docs
سيُطلب منك ربط الأداة.
انقر على الرابط لربط الأداة. تفتح صفحة Gemini Code Assist
الموظفون والأدوات.
حدِّد الأداة التي تريد استخدامها، ثم انقر على
ربط حسابك. ستفتح صفحة تفاصيل الأداة.
في صفحة تفاصيل الأداة، انقر على ربط، ثم اتّبِع التعليمات
للمصادقة على خدمة الأداة وربط حسابك.
للحصول على قائمة بالأدوات وبعض الطلبات المقترَحة، يُرجى الاطّلاع على الأدوات المتاحة.
إزالة التفويض من أداة
لإزالة التفويض من أداة في IDE، أكمِل الخطوات التالية:
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Configure Gemini Code Assist tools\n\n| **Preview**\n|\n| This product or feature is in preview. Products and features that are\n| in preview are available \"as is\".\n\nThis document describes how to configure Gemini Code Assist tools for\nuse in your IDE.\n\nTo learn more about Gemini Code Assist tools and view all available\ntools, read the [Gemini Code Assist tools overview](/gemini-code-assist/docs/tools-agents/tools-overview).\n\nBefore you begin\n----------------\n\n1. Ask your administrator to do the following:\n\n 1. [Set up Gemini Code Assist Standard and Enterprise](/gemini-code-assist/docs/set-up-gemini-standard-enterprise).\n 2. [Enable Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/enable-tools-standard-enterprise).\n2. [Install the Gemini Code Assist plugin in your IDE](/gemini-code-assist/docs/set-up-gemini-standard-enterprise#use-ide).\n\n### Required roles\n\nTo get the permissions that you need to use Gemini Code Assist tools, ask your administrator to grant you the following IAM roles on the Google Cloud project:\n\n\u003cbr /\u003e\n\n- [Gemini Code Assist Tools User](https://cloud.google.com/iam/docs/roles-permissions/cloudaicompanion#cloudaicompanion.codeToolsUser) (`roles/cloudaicompanion.codeToolsUser`)\n\nFor more information about granting roles, see\n[Manage access to projects, folders, and organizations](https://cloud.google.com/iam/docs/granting-changing-revoking-access).\n\nYou might also be able to get the required permissions through\n[custom roles](https://cloud.google.com/iam/docs/creating-custom-roles) or\nother [predefined roles](https://cloud.google.com/iam/docs/understanding-roles).\n\nIndividual tools might require additional Google Cloud or third-party roles and\npermissions to use, or for specific use cases. If you encounter permissions\nerrors, check with your administrator to make sure you have the correct roles\nand permissions.\n\n\n### Dependencies\n\nSome tools have dependencies you must install or enable before use. Some\nexamples of dependencies that might be required are:\n\n- An extension might need to be installed in your IDE.\n- A product or service might need to be enabled in your Google Cloud project.\n- An account or project might need to be created for a service.\n\nYou will be prompted to take the required actions the first time you prompt a\ntool in the Gemini Code Assist chat.\n\nConfigure a tool for use in the IDE\n-----------------------------------\n\n1. In your IDE, navigate to the Gemini Code Assist chat and prompt\n the tool you want to use by using the `@` symbol followed by the name of\n the tool.\n\n For example, the following prompt is sent to the Google Docs tool: \n\n @GoogleDocs get my docs\n\n You are prompted to connect the tool.\n2. Click the link to connect the tool. The Gemini Code Assist\n **Agents \\& Tools** page opens.\n\n3. Locate the tool that you want to use and then click\n **Connect your account**. The tool details page opens.\n\n | **Note:** you can't connect your account if the tool hasn't been enabled by an administrator.\n4. In the tool details page, click **Connect** and then follow the instructions\n to authenticate to the tool service and connect your account.\n\nFor a list of tools and some suggested prompts, see\n[available tools](/gemini-code-assist/docs/tools-agents/tools-overview#available-tools-standard-enterprise).\n\nRemove authorization from a tool\n--------------------------------\n\nTo remove authorization from a tool in your IDE, complete the following steps:\n\n1. Navigate to Developer Connect.\n\n [Go to Developer Connect](https://console.cloud.google.com/developer-connect)\n2. Click **Account Connectors**.\n\n3. Find the account connector for the tool service you want to remove, and then\n click the name of the account connector. The connector details page opens.\n\n4. In the row containing your account, click\n more_vert**More options**.\n\n5. Click **Delete**.\n\n Your account is removed from the account connector. The tool is no longer\n authorized to access its service from your IDE.\n | **Note:** if you want to authorize the tool again with a different account, you might need to log out of the tool account and then log back in with the new account you want to authorize\n\nWhat's next\n-----------\n\n- Try out the GitHub or GitLab tool by following the instructions in [Get started with Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/get-started-with-tools-standard-enterprise)."]]