Pular para o conteúdo principal

Suporte a skills no Unity Gateway

info

Beta

Este recurso está na Beta. Para usá-lo, um administrador do workspace deve ativar Habilidades do Unity Gateway no Genie na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

As habilidades do Unity Gateway fornecem um local central para descobrir, publicar e governar as habilidades de agentes em toda a sua organização. Não há cópias para manter em sincronia, e qualquer pessoa com acesso pode descobrir o que já existe em vez de ficar perguntando por aí.

No Databricks, uma skill é um objeto protegido de primeira classe do Unity Catalog (catalog.schema.skill), portanto, você a compartilha com pessoas ou grupos usando as mesmas permissões, tags e auditoria que protegem suas tabelas.

As habilidades do Unity Gateway seguem o formato de especificação SKILL.md. As habilidades ensinam um agente a executar bem uma tarefa, como analisar uma tabela, seguir um runbook ou aplicar as convenções de SQL da sua equipe.

Os autores e as equipes centrais criam uma skill a partir de um arquivo SKILL.md e arquivos de suporte, então a publicam no registro de skills no UC. Permissões, tags, logs de auditoria e pesquisa regem as skills publicadas. Seu agente descobre skills acessíveis, mantém breves metadados no contexto e carrega a skill completa quando necessário.

Os autores e as equipes centrais escrevem um arquivo SKILL.md com arquivos de suporte e publicam a skill em um registro no Unity Catalog. O registro aplica permissões, tags e logs de auditoria e torna as skills pesquisáveis. O seu agente descobre skills que você pode acessar, mantém um pequeno conjunto de metadados da skill em contexto e carrega a skill completa quando uma tarefa precisa dela.

Acessar habilidades sobre MCP​

O servidor MCP do Databricks Skills permite que um agente descubra e leia habilidades no Unity Catalog. Para agentes de codificação suportados, use a CLI do Unity Gateway para conectar-se ao registro de habilidades.

Para conectar outro cliente MCP diretamente, use https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>. Substitua os espaços reservados pelo seu hostname de workspace e esquema e, em seguida, autentique-se no workspace em seu cliente. Para incluir vários esquemas, repita o parâmetro schema:

Text
https://<workspace-hostname>/ai-gateway/skills/?schema=acme.sql_skills&schema=acme.analytics_skills

Os esquemas selecionados limitam a descoberta. As permissões do Unity Catalog ainda controlam quais habilidades o cliente pode acessar.

O servidor oferece suporte à interface Skills MCP e à extensão Skills over MCP na mesma URL. O Databricks permite a extensão por meio de uma distribuição gerenciada. Onde está habilitado, as solicitações que anunciam a capacidade Skills usam a extensão. Todas as outras solicitações usam a interface Skills MCP. Para um cliente personalizado, inclua io.modelcontextprotocol/skills em params._meta["io.modelcontextprotocol/clientCapabilities"].extensions em cada solicitação.

Ambas as interfaces permitem que os agentes descubram e leiam habilidades e retornem instruções da CLI do Databricks para gerenciá-las. O servidor não executa comandos nem faz upload de arquivos. Você ou seu agente fazem a execução dos comandos localmente. Veja Criar e compartilhar habilidades de Gateway do Unity.