Criar e gerenciar habilidades

As habilidades são instruções personalizadas que ficam salvas e ajudam o assistente do Gemini Enterprise a realizar tarefas específicas, como revisar contratos legais ou escrever com a voz da sua marca.

Observação: para criar habilidades, o administrador precisa ativar o recurso de habilidades. Da mesma forma, para compartilhar habilidades, o administrador também precisa ativar o compartilhamento de habilidades, que pode ser configurado para exigir a análise do administrador ou permitir o compartilhamento imediato. Para mais informações, consulte Gerenciar habilidades.

Cada habilidade é um pacote que contém um arquivo de comando SKILL.md. Um pacote de habilidades também pode incluir scripts, arquivos ou contexto de segundo plano que o assistente usa para concluir uma tarefa. Por padrão, o Gemini Enterprise ativa as habilidades que você cria.

Edições compatíveis

A capacidade de criar, fazer upload ou usar habilidades depende da edição do Gemini Enterprise que você assina:

• Standard, Plus e pagamento por uso: é possível criar e fazer upload de habilidades personalizadas, além de usar habilidades gerenciadas pelo Google e criadas por usuários que foram compartilhadas com você.
• Frontline: é possível procurar, instalar e usar habilidades gerenciadas pelo Google e habilidades criadas por usuários compartilhadas com você. Não é possível criar nem fazer upload de habilidades personalizadas.

Visão geral

Os principais aspectos das habilidades incluem:

• Padrão aberto: cada habilidade é definida por um arquivo SKILL.md principal e pode ser estendida com outros arquivos ou scripts.
• Extensão modular:as habilidades permitem ensinar ao agente tarefas específicas do domínio usando instruções e contexto personalizados.
• Acesso dinâmico:o Gemini Enterprise acessa essas instruções especializadas automaticamente quando elas são relevantes para sua pergunta ou tarefa.

Criar uma habilidade

Observação: não é possível criar habilidades com a edição Gemini Enterprise Frontline. Para mais informações, consulte Edições compatíveis.

Para criar uma habilidade no app da Web do Gemini Enterprise, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Clique no ícone adicionar e em Criar habilidade com o Gemini.
4. Insira um nome para a habilidade.
5. Digite uma descrição. O Gemini Enterprise usa a descrição para determinar se a habilidade pode ajudar com um comando ou uma tarefa. Você também pode adicionar instruções de acionamento à descrição para ajudar a orientar o Gemini Enterprise.
6. Forneça as instruções da habilidade usando linguagem natural na caixa de chat ou no campo Instruções. Para criar uma habilidade usando um arquivo SKILL.md com Markdown personalizado ou front matter YAML, consulte Fazer upload de uma habilidade.
7. Clique em Salvar. O Gemini Enterprise ativa a nova habilidade por padrão.

Enviar uma habilidade

Observação: não é possível fazer upload de habilidades com a edição Gemini Enterprise Frontline. Para mais informações, consulte Edições compatíveis.

Para adicionar habilidades, faça upload delas como arquivos Markdown ou ZIP. O Gemini Enterprise extrai automaticamente o nome e a descrição da habilidade do arquivo SKILL.md.

Formato do arquivo de habilidade e estrutura de diretórios

Um pacote de habilidades consiste em um arquivo de comando SKILL.md obrigatório e subdiretórios opcionais para scripts, documentação de referência e recursos. É possível fazer upload de um arquivo SKILL.md independente ou de um arquivo ZIP com a seguinte estrutura de diretórios:

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output

Arquivo ou diretório	Obrigatório	Descrição
SKILL.md	Sim	Contém os metadados do frontmatter YAML da habilidade (como name e description) seguidos por instruções em Markdown que orientam o assistente do Gemini Enterprise.
scripts/	Não	Scripts auxiliares executáveis em Python ou Bash para operações determinísticas ou repetidas.
references/	Não	Contexto complementar carregado sob demanda, como esquemas, folhas de referência ou documentação de referência da API.
assets/	Não	Arquivos usados na saída (como modelos ou imagens) que não são carregados diretamente no contexto do comando do Gemini Enterprise.

Requisitos do frontmatter YAML

O arquivo SKILL.md precisa começar com um bloco de frontmatter YAML válido entre delimitadores --- no início do arquivo, seguido pelo corpo das instruções em Markdown (limite rígido de 500.000 caracteres; uploads que excedem esse limite falham).

O frontmatter YAML é compatível com os seguintes campos:

Campo	Obrigatório	Formato e restrições
name	Sim	Um identificador exclusivo para a habilidade (de 1 a 64 caracteres). Precisa conter apenas letras minúsculas (a-z), números (0-9) e hifens (-). Não pode começar nem terminar com um hífen (-) nem conter hifens consecutivos (--). Se for enviado para uma pasta, o valor de name precisa corresponder ao nome da pasta mãe.
description	Sim	Uma descrição funcional (de 1 a 1.024 caracteres) explicando o que a habilidade faz e quando o Gemini Enterprise deve invocá-la. Inclua palavras-chave de acionamento para ajudar o Gemini Enterprise a identificar quando a habilidade é relevante. Esse é um limite rígido. Se a descrição exceder 1.024 caracteres, o upload da habilidade vai falhar com o erro: A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license	Não	A licença de distribuição de software ou conteúdo que se aplica ao pacote de habilidades (até 1.024 caracteres), como um identificador de licença SPDX de código aberto (por exemplo, Apache-2.0 ou MIT) ou Proprietary. Esse campo especifica os termos de uso do arquivo de habilidade, não uma licença de assinatura de usuário corporativo ou app do Gemini Enterprise. Se especificado, o valor não pode ficar vazio.
metadata	Não	Um mapa de chave-valor opcional de tags personalizadas, autores ou parâmetros de versão. As chaves precisam ser strings escalares, e os valores precisam ser strings escalares ou listas de strings escalares.

Exemplo de arquivo SKILL.md:

O exemplo a seguir mostra um arquivo SKILL.md válido:

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

Restrições de arquivos ZIP

Ao fazer upload de uma habilidade como um arquivo ZIP, verifique se ele atende aos seguintes requisitos de validação:

• Arquivo SKILL.md único:cada arquivo ZIP precisa conter exatamente um arquivo SKILL.md localizado na raiz do arquivo (SKILL.md) ou em uma única pasta wrapper de nível superior (com até três níveis de profundidade, como my-skill/SKILL.md).
• Tamanho do arquivo:tamanho máximo do arquivo ZIP compactado de 100 MB e tamanho total máximo descompactado de 100 MB.
• Contagem de arquivos:no máximo 100 arquivos por arquivo ZIP.
• Profundidade de aninhamento de diretórios:profundidade máxima de aninhamento de diretórios de 10 níveis em relação à raiz da habilidade.
• Integridade do caminho:não são permitidos caminhos de arquivo duplicados e referências de diretório pai (..).

Fazer upload de uma habilidade para o app da Web

Para fazer upload de uma habilidade, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Clique no ícone adicionar e em Fazer upload de habilidade.
4. Arraste ou procure o arquivo Markdown ou ZIP e clique em Importar. O Gemini Enterprise ativa a habilidade por padrão.

Observação: se o upload falhar com um erro como Upload failed. Details: Request contains an invalid argument, verifique o seguinte:

• O arquivo SKILL.md começa com um frontmatter YAML válido entre delimitadores ---.
• O frontmatter inclui os campos obrigatórios name e description dentro dos limites de caracteres.
• O campo name usa apenas letras minúsculas, números e hífens (e corresponde ao nome da pasta mãe se for enviado em um arquivo ZIP).
• O arquivo obedece às restrições de arquivos ZIP.

Procurar habilidades

É possível procurar e instalar habilidades usando as seguintes seções para filtrar a lista:

Seção	Descrição
Todos	Habilidades gerenciadas pelo Google e criadas pelo usuário.
Google	Habilidades integradas fornecidas pelo Google.
Compartilhados comigo	Habilidades somente leitura criadas por usuários que foram compartilhadas com você.

Para procurar e instalar uma skill, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Clique no ícone Adicionar e em Procurar habilidades.
4. Encontre a habilidade que você quer usar e clique em + Instalar.

Atualizar uma habilidade

Para atualizar uma habilidade, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Clique no nome da habilidade que você quer atualizar.
4. Clique no ícone ao lado da habilidade e em Editar.
5. Faça as atualizações necessárias nas instruções, no nome ou na descrição.
6. Clique em Salvar.

Para voltar à página "Habilidades", clique em Habilidades.

Compartilhar uma habilidade

Se o administrador do Gemini Enterprise ativar o compartilhamento de habilidades, você poderá compartilhar as habilidades que criar com outros usuários.

Observação: o compartilhamento de uma habilidade não envia uma notificação por e-mail. Para encontrar a habilidade, os destinatários precisam acessar a seção Compartilhadas comigo em Procurar habilidades.

Para compartilhar uma habilidade, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Encontre a habilidade que você criou e quer compartilhar.
4. Clique no ícone ao lado da habilidade e em Compartilhar.
5. Na caixa de diálogo Compartilhar habilidade, insira os endereços de e-mail separados por vírgulas dos usuários com quem você quer compartilhar a habilidade.
6. Clique em Concluído.

Observação: se o administrador do Gemini Enterprise exigir aprovação para pedidos de compartilhamento, outros usuários não poderão acessar a habilidade até que o administrador aprove o pedido.

Usar uma habilidade

Você pode usar as habilidades diretamente nas conversas no app da Web do Gemini Enterprise.

Testar uma habilidade na página "Habilidades"

Para testar uma habilidade diretamente na página Habilidades, inicie uma nova sessão de chat com ela:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Clique no ícone ao lado da habilidade e em Nova conversa. O Gemini Enterprise abre uma nova conversa que faz referência à habilidade selecionada.

Invocar uma habilidade em uma conversa

É possível invocar habilidades dinamicamente durante uma conversa para personalizar as respostas do assistente.

Observação: é possível usar habilidades e agentes de forma dinâmica, mas não é possível invocar um agente e uma habilidade no mesmo comando.

Ao conversar com o assistente do Gemini Enterprise, você pode usar as habilidades das seguintes maneiras:

• Menções manuais:é possível invocar explicitamente uma habilidade usando o recurso de menção @ ou / na caixa de chat (por exemplo, @Brand Voice ou /Brand Voice). Digitar / abre um menu que mostra apenas as habilidades disponíveis, enquanto digitar @ abre o menu de menções gerais.
• Comandos diretos:se você precisar que o Gemini Enterprise use uma habilidade específica, peça diretamente no comando. Por exemplo, Use the brand voice skill to review this.
• Seleção automática:o Gemini Enterprise usa automaticamente uma habilidade quando ela é relevante para sua tarefa com base na descrição e nas instruções de acionamento.

Desativar uma habilidade

Para impedir que o Gemini Enterprise use uma habilidade específica, desative-a. Quando você desativa uma habilidade, o Gemini Enterprise não a invoca em conversas.

Para desativar uma habilidade, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Na página Habilidades, encontre a habilidade que você quer desativar.
4. Clique no botão ao lado da skill para a posição Desativado.

Desinstalar uma habilidade

Para remover uma habilidade instalada da página Habilidades, siga estas etapas:

1. Faça login no app da Web Gemini Enterprise.
2. No menu de navegação, clique em Habilidades.
3. Clique no ícone ao lado da skill e em Desinstalar.

Observação: desativar uma habilidade pausa o acionamento automático, mas a mantém na página Habilidades. Desinstalar uma habilidade a remove da página Habilidades, mas ela continua disponível em Procurar habilidades para reinstalação.

Estados de habilidade

Além de ativar ou desativar as habilidades por conta própria, o administrador pode mudar o estado de uma habilidade, o que afeta a disponibilidade dela:

• Suspenso:o administrador desativa temporariamente a habilidade. Ela permanece visível na página Habilidades com o status de suspensa, mas outros usuários não podem invocá-la em conversas até que o administrador a reative. Os proprietários podem atualizar e testar a habilidade.
• Desativada: o administrador oculta temporariamente a habilidade de outros usuários, removendo-a da página Habilidades. A habilidade permanece visível para o proprietário, que pode atualizá-la e testá-la até que o administrador a reative.
• Excluída: o administrador remove permanentemente a habilidade do app da Web do Gemini Enterprise, então você não pode mais usá-la.

Limitações

Esta seção lista as limitações das habilidades no Gemini Enterprise:

• As habilidades não estão disponíveis para uso com agentes.
• As habilidades só são compatíveis com a execução em Python e Bash.
• O editor de app da Web permite criar habilidades inserindo instruções nos campos do formulário ou conversando com o assistente, que gera automaticamente um único arquivo SKILL.md. É necessário fazer upload de habilidades mais complexas que exigem scripts ou arquivos adicionais como um arquivo ZIP.
• A criação de habilidades em linguagem natural não usa o contexto da conversa ou conectores como entradas para criar uma habilidade.
• As habilidades funcionam melhor com o Canvas quando têm apenas um arquivo SKILL.md.
• Um arquivo SKILL.md tem limites rígidos de comprimento de 64 caracteres para name, 1.024 caracteres para description e 500.000 caracteres para o corpo das instruções Markdown. Os arquivos ZIP enviados não podem exceder 100 MB (compactados ou não), 100 arquivos ou 10 níveis de aninhamento de diretório.

A seguir

• Saiba como os administradores gerenciam habilidades.