Este artigo explica como proprietários de organizações podem provisionar habilidades para todos os usuários em sua organização. Provisionar habilidades para sua equipe permite distribuir fluxos de trabalho e capacidades aprovados em toda a organização a partir de um local centralizado.
O gerenciamento de habilidades em toda a organização está disponível para planos Team e Enterprise.
Pré-requisitos
Antes de provisionar habilidades para sua organização, você deve ativar dois recursos alternando-os:
Execução de código e criação de arquivos em Configurações da organização > Capacidades
Habilidades em Configurações da organização > Habilidades
As habilidades requerem execução de código para funcionar, portanto, se a execução de código estiver desativada, as habilidades não estarão disponíveis.
Provisionar habilidades para sua organização
Quando você carrega uma habilidade através das configurações da organização, ela fica automaticamente disponível para todos os usuários em sua organização em Personalizar > Habilidades. Isso significa que usuários individuais não precisam mais carregar manualmente as mesmas habilidades.
Para provisionar uma habilidade:
Navegue até Configurações da organização > Habilidades.
Na seção Habilidades da organização, clique em "+ Adicionar".
Selecione um arquivo .zip contendo sua habilidade (deve incluir um arquivo SKILL.md).
A habilidade é imediatamente provisionada para todos os usuários em sua organização.
As habilidades provisionadas pelo administrador são ativadas por padrão para todos em sua organização, mas os usuários ainda podem desativar habilidades individuais se escolherem. Isso oferece às organizações fluxos de trabalho consistentes e aprovados entre equipes, enquanto permite que usuários individuais personalizem sua experiência.
Definir status padrão
Ao provisionar uma habilidade, você pode escolher se ela deve estar ativada ou desativada por padrão:
Ativada por padrão: A habilidade fica automaticamente ativa para todos. As pessoas ainda podem desativá-la individualmente se preferirem.
Desativada por padrão: A habilidade aparece na lista de habilidades de cada pessoa, mas não fica ativa até que eles a ativem.
As pessoas sempre podem ativar ou desativar habilidades provisionadas pelo proprietário com base em suas preferências, independentemente da configuração padrão.
Controlar compartilhamento de habilidades entre membros
Além de provisionar habilidades de cima para baixo, você pode permitir que membros compartilhem habilidades que construíram uns com os outros. Dois alternadores independentes controlam isso:
Compartilhamento de habilidades: Os membros podem compartilhar uma habilidade com colegas específicos. Os destinatários veem a habilidade na seção Compartilhado com você de sua lista de habilidades.
Compartilhar com a organização: Os membros podem publicar uma habilidade no diretório da organização, onde qualquer pessoa pode encontrá-la e instalá-la.
Ambos os alternadores estão desativados por padrão. Você pode ativar um ou ambos em Configurações da organização > Habilidades.
Nota: As habilidades compartilhadas são somente leitura. Os destinatários podem ativar e usar uma habilidade compartilhada, mas não podem editar seu conteúdo. O compartilhamento em grupo e permissões de edição estão planejados para uma versão futura.
Como habilidades compartilhadas diferem de habilidades provisionadas
| Provisionada pelo proprietário | Compartilhada ponto a ponto | Compartilhada em toda a organização |
Quem pode compartilhar | Apenas proprietários | Qualquer membro (se ativado) | Qualquer membro (se ativado) |
Onde aparece | Lista de habilidades de todos | Seção "Compartilhado com você" do destinatário | Diretório da organização |
Os destinatários podem removê-lo? | Apenas desativar | Desativar ou excluir | Apenas desativar |
Requer aprovação do proprietário? | Proprietário carrega diretamente | Não | Não |
Importante: Não há fluxo de trabalho de aprovação para compartilhamento em toda a organização. Se você ativar Compartilhar com a organização, qualquer membro pode publicar uma habilidade no diretório sem revisão. Considere ativar apenas o compartilhamento ponto a ponto se isso for uma preocupação.
Monitorar atividade de compartilhamento
Os eventos de compartilhamento de habilidades são capturados no log de auditoria e na API de Conformidade como eventos role_assignment. Você pode ver quem compartilhou uma habilidade, com quem e se foi ponto a ponto ou em toda a organização.
O log de auditoria não captura o conteúdo das habilidades compartilhadas—apenas o evento de compartilhamento em si. Não há painel de administrador para procurar ou inspecionar o conteúdo de habilidades compartilhadas entre membros.
Como membros veem habilidades provisionadas e compartilhadas
As habilidades aparecem para cada membro em Personalizar > Habilidades, organizadas em três seções:
Habilidades pessoais: Habilidades que o membro criou ou carregou.
Compartilhado com você: Habilidades que colegas compartilharam diretamente com um membro. Estas aparecem esmaecidas até serem ativadas.
Habilidades da organização: Habilidades que um proprietário provisionou e habilidades que membros compartilharam em toda a organização. Os membros instalam estas do diretório.
As habilidades provisionadas pelo proprietário são marcadas com um indicador visual para que os membros possam distingui-las de outros tipos de habilidades. Os membros podem clicar em qualquer habilidade para visualizar seu conteúdo e descrição.
Para mais informações sobre como membros navegam e instalam do diretório, consulte Procurar habilidades, conectores e plugins em um diretório.
Como usuários veem habilidades provisionadas
As habilidades provisionadas por um proprietário de organização aparecerão para cada usuário em Personalizar > Habilidades ao lado de habilidades Anthropic e de qualquer habilidade que eles tenham carregado.
Essas habilidades são marcadas com um indicador visual para que os usuários possam distingui-las de outros tipos de habilidades. Os usuários podem clicar em qualquer habilidade para visualizar seu conteúdo e descrição.
Gerenciar e remover habilidades provisionadas
A seção Habilidades da organização em Configurações da organização > Habilidades exibe todas as habilidades que foram provisionadas para sua organização. Você pode usar a pesquisa e os títulos de seção para navegar suas habilidades provisionadas.
Para remover uma habilidade de sua organização, localize-a na lista Habilidades da organização e selecione a opção para removê-la. Uma vez removida, a habilidade não aparecerá mais nas listas de Habilidades dos usuários em Personalizar > Habilidades.
Nota: Apenas proprietários podem adicionar ou remover habilidades em toda a organização. Usuários individuais não podem excluir habilidades provisionadas, embora possam desativá-las para seu próprio uso.
Melhores práticas
Teste habilidades antes de provisionar: Carregue e teste habilidades em sua própria conta primeiro para verificar se funcionam conforme esperado antes de distribuí-las em toda a organização.
Use nomes descritivos: Dê às habilidades nomes claros que ajudem os usuários a entender seu propósito à primeira vista.
Escreva descrições claras: A descrição da habilidade ajuda Claude a determinar quando usá-la automaticamente. Certifique-se de que as descrições refletem com precisão o que a habilidade faz.
Considere o status padrão cuidadosamente: Ative habilidades por padrão quando forem amplamente úteis para a maioria dos usuários. Use desativado por padrão para habilidades especializadas que apenas alguns membros da equipe precisam.
Decida sobre compartilhamento deliberadamente: O compartilhamento ponto a organização não tem etapa de aprovação. Se você quiser revisar habilidades antes que elas cheguem a todos, mantenha o compartilhamento em toda a organização desativado e peça aos membros que enviem habilidades a um proprietário para provisionar.