Manage skills

User-created skills are reusable instructions that help the Gemini Enterprise assistant perform specific tasks.

By default, Gemini Enterprise turns off the skills feature. As a Gemini Enterprise administrator, you can turn on skills, manage skill sharing, and require administrator approval for shared skills.

Note: Skills don't have specific location restrictions. Their availability depends on the model selected in the chat conversation. For more information, see Gemini Enterprise limitations.

Before you begin

• To perform administrative tasks related to skills, you must have the Gemini Enterprise Admin IAM role (roles/discoveryengine.agentspaceAdmin).
• To use skills, you must have a license for one of the following Gemini Enterprise editions: Standard, Plus, Pay as you go, or Frontline.

Turn on skills and configure sharing

To allow users to create, use, and share skills, you must turn on the feature in the Feature Management settings.

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that you want to configure.

3. Click Configurations and then click the Feature Management tab.

4. Turn on the following toggles based on your use case:

   Toggle	Description
   Enable skills	Allow users to create and use skills.
   Enable skill sharing	Allow users to share skills with other users. To enable this setting, you must turn on Enable skills. If you don't also turn on the Enable skill sharing without admin approval, administrators must review and approve pending skill share requests.
   Enable skill sharing without admin approval	Allow users to share and use skills immediately without requiring administrator review. To enable this setting, you must turn on Enable skills and Enable skill sharing.

For more information about feature management, see Manage web app features.

View skills

To view the skills created by users, follow these steps:

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills. The Skills page appears, listing all skills created by users.

Review share requests

If you have configured skill sharing to require administrator approval, you can review pending share requests on the Skills page. Follow these steps:

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills.

4. On the Skills page, look for skills with a pending sharing status.

5. Click Review share request.

6. Select the users you want to share the skill with.

7. Click Approve to allow the skill to be shared, or Deny to deny the request.

Suspend a skill

To temporarily suspend a skill created by a user and make it unavailable for use, follow these steps:

Note: You can't use administrator controls to suspend Google-managed skills for all end users. But, end users can turn off Google-managed skills they installed if they don't want to use them.

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills.

4. On the Skills page, click next to the skill you want to suspend.

5. Enter the reason for suspending the skill.

6. Click Suspend.

The skill status changes to Suspended. The skill remains visible in the end-user skill gallery with a Suspended label next to its name, but users can no longer invoke it in conversations. The skill owner can update and test the skill.

Disable a skill

To hide a skill that is shared with users and prevent its use, follow these steps:

Note: You can't use administrator controls to disable Google-managed skills for all users. End users can turn off Google-managed skills they installed if they don't want to use them.

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills.

4. On the Skills page, click next to the skill you want to disable.

5. Click Disable.

Gemini Enterprise hides the skill from the end-user skill gallery.

Enable a skill

To re-enable a suspended or disabled skill, follow these steps:

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills.

4. On the Skills page, click next to the suspended or disabled skill.

5. Click Enable. The skill becomes available for use.

Reject a skill

When you reject a skill that is in the Disabled state, Gemini Enterprise returns it to the Private state and makes it available only to the skill owner. You must enter a reason for the rejection.

Note: Due to a known limitation, the web app doesn't show the reason for rejection to the skill owner.

To reject a skill, follow these steps:

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills.

4. On the Skills page, click next to the disabled skill you want to reject.

5. Click Reject.

6. Enter a reason for the rejection.

7. Click Confirm.

Delete a skill

To permanently delete a user-created skill, follow these steps:

Note: You can't delete Google-managed skills.

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that has the skill.

3. Click Skills.

4. On the Skills page, click next to the skill you want to delete.

5. Click Delete.

Skill states

The following table describes each state that a skill might be in:

State	Description
Private	The skill isn't shared with other users and is only available to the skill owner.
Suspended	The skill is temporarily deactivated. The skill remains visible in the end-user gallery with a Suspended label next to its name, but users can no longer invoke it in conversations. Skill owners can update and test the skill.
Enabled	The skill is active and available for use on the web app.
Disabled	The skill is inactive and hidden completely from the end user's Skills page. Users can't interact with the skill until you re-enable it. Skill owners can update and test the skill.

What's next

• Learn how users create and manage skills.
• Learn more about how to manage web app features.