Personalizando o Genie Code com instruções, habilidades, memória e MCP

O Genie Code funciona melhor quando entende como sua equipe realmente opera: seus padrões de codificação, fluxos de trabalho internos, ferramentas compartilhadas e o contexto por trás de decisões anteriores.

É por isso que apresentamos um conjunto de recursos que permitem adaptar o Genie Code à sua organização e aos seus fluxos de trabalho. As Instruções ajudam a definir as preferências de toda a equipe, as Habilidades capturam fluxos de trabalho repetíveis e os Servidores MCP conectam o Genie Code diretamente a sistemas como Jira, GitHub e Google Drive.

Instruções personalizadas

Instruções personalizadas permitem definir preferências persistentes que o Genie Code aplica em cada sessão no modo agente. Elas são ideais para aspectos que sempre se aplicam ao seu modo de trabalhar: sua linguagem de programação preferida, formato de saída ou diretrizes gerais de estilo.

A limitação é que as instruções são globais. Se você adicionar uma regra de formatação SQL, ela será aplicada quer você esteja escrevendo SQL ou depurando Python. Para preferências que se aplicam a todos os lugares, as instruções são a ferramenta certa. Para contextos que só são relevantes para uma tarefa específica, você precisa de algo mais direcionado.

Para convenções no nível da equipe, o Genie Code também pode descobrir automaticamente os arquivos AGENTS.md e CLAUDE.md no seu projeto. Assim que esses arquivos são enviados para um repositório, o Genie Code os detecta automaticamente, para que os colegas de equipe não precisem configurar o mesmo contexto individualmente.

Habilidades do agente

As Habilidades do agente são uma forma de ensinar o Genie Code a realizar tarefas específicas do jeito que você faz.

Uma habilidade é um pacote baseado em markdown que descreve um fluxo de trabalho, padrão ou ação que o Genie Code pode usar ao operar no modo agente. As habilidades podem incluir orientações, código reutilizável e scripts executáveis, todos com escopo definido para uma tarefa específica, em vez de serem aplicados globalmente.

Cada habilidade inclui um nome e uma descrição que ajudam o Genie Code a determinar quando ela é relevante. Quando uma solicitação corresponde a uma habilidade, o Genie Code a carrega e usa as orientações, padrões e códigos que ela contém para responder adequadamente.

Como adicionar habilidades?

Para começar:

1. Abra sua pasta de habilidades. No Genie Code, abra as Configurações, navegue até Habilidades do usuário e selecione Abrir pasta de habilidades. Isso abrirá seu diretório pessoal de habilidades (/Users/{username}/.assistant/skills/).
2. Crie ou atualize uma habilidade. Adicione um novo arquivo markdown. Cada habilidade deve incluir um nome e uma descrição claros para que o Genie Code saiba quando aplicá-la. Você pode organizar arquivos relacionados em pastas e, opcionalmente, incluir scripts para fluxos de trabalho mais avançados.

Habilidades do workspace

Além das habilidades pessoais, os administradores do workspace podem criar habilidades que ficam automaticamente disponíveis para todos no workspace. As habilidades do workspace ficam em Workspace/.assistant/skills/.

As habilidades do workspace seguem o mesmo formato das habilidades pessoais, mas têm como escopo a equipe, e não um indivíduo. Isso as torna ideais para fluxos de trabalho que devem ser compartilhados e usados de forma consistente em toda a organização — por exemplo, uma habilidade que impõe convenções de nomenclatura de pipeline de ML, direciona o Genie Code para o runbook interno correto durante a resposta a incidentes ou aplica as verificações padrão de qualidade de dados da sua equipe a cada novo pipeline.

Servidores MCP

As habilidades abordam o contexto que está na sua cabeça ou nos padrões da sua equipe. Os servidores MCP abordam o contexto que já existe em outro lugar.

No início de 2025, apresentamos o suporte a MCP no Databricks para disponibilizar um contexto externo rico para agentes de AI de forma governada e escalável. O MCP oferece uma maneira padronizada de expor ferramentas, dados e fluxos de trabalho ao Genie Code sem incorporar esse contexto diretamente em prompts ou instruções.

O Genie Code agora pode aproveitar quaisquer servidores MCP que tenham sido adicionados ao seu workspace e que você tenha permissão para usar. Os administradores do workspace controlam quais servidores estão disponíveis, enquanto os usuários podem selecionar a partir dessas fontes aprovadas conforme necessário.

Para ferramentas comuns como Google Drive, SharePoint e GitHub, o Databricks também oferece fluxos OAuth gerenciados, atualmente em beta, que tratam da autenticação sem a configuração manual de tokens. Para habilitar isso, ative os Conectores de terceiros para agentes em suas configurações de preview. A partir daí, qualquer usuário pode habilitar esses servidores MCP simplesmente clicando no botão de adição na barra de prompt do Genie Code.

O MCP foi projetado para casos em que um contexto importante já existe, mas é difícil de acessar a partir do Genie Code. Por exemplo:

• Sistemas de documentação interna. As equipes frequentemente mantêm runbooks ou documentos operacionais em ferramentas como o Confluence. Em vez de copiar seções nos prompts, esse conteúdo pode ser exposto uma vez e referenciado quando for relevante.
• Ferramentas e serviços internos. As equipes de plataforma podem manter APIs ou scripts para configuração, validação ou implantação. O MCP permite que esses recursos sejam disponibilizados diretamente para o Genie Code, em vez de serem explicados ou colados repetidamente.

Nesses casos, o MCP substitui o copiar e colar manual por uma abordagem estruturada e reutilizável, disponibilizando o contexto correto apenas quando necessário.

Como adicionar servidores MCP?

O Databricks oferece suporte a vários tipos de servidores MCP, incluindo servidores gerenciados para serviços do Databricks, servidores externos conectados por meio do Unity Catalog e servidores MCP personalizados hospedados no Databricks Apps. Você pode navegar pelos servidores disponíveis no marketplace do MCP, que pode ser acessado diretamente do painel de configurações do Genie Code. Os administradores do workspace controlam quais servidores estão disponíveis, e os usuários podem selecionar entre os servidores que têm permissão para usar.

Depois que os servidores MCP estiverem disponíveis em seu workspace, usá-los no Genie Code é simples:

1. Abra as configurações do Genie Code
2. Selecione Adicionar servidor
3. Escolha entre os tipos de servidor MCP disponíveis
4. Salve sua seleção
5. Se o servidor exigir autenticação, siga as instruções de login para autorizar a conexão. Suas credenciais são armazenadas de forma segura e você não precisará se autenticar novamente a cada sessão.

Os servidores MCP ficam disponíveis imediatamente após serem adicionados. O Genie Code acessa as ferramentas desses servidores automaticamente quando relevante.

Dicas e truques

• Deixe o Genie Code criar habilidades para você. Depois de trabalhar em um fluxo de trabalho no modo agente, basta dizer ao Genie Code para capturá-lo como uma habilidade; ele gerará o arquivo markdown e o salvará na sua pasta de habilidades automaticamente.
• Mantenha as habilidades focadas. Um fluxo de trabalho por arquivo de habilidade facilita para o Genie Code saber quando aplicá-lo e torna a manutenção mais simples ao longo do tempo. O nome e a descrição são o que o Genie Code usa para decidir quando uma habilidade é relevante, então quanto mais específicos forem, melhor.
• As habilidades são apenas arquivos markdown. Isso significa que elas são fáceis de compartilhar, controlar a versão e sincronizar com sua equipe. Para exemplos prontos para uso para começar, consulte o repositório de demonstração de habilidades do Genie Code.
• Convenções de equipe portáteis: O Genie Code detecta automaticamente os arquivos AGENTS.md e CLAUDE.md em seu workspace e os aplica sem configuração adicional. As equipes podem compartilhar as mesmas convenções, instruções e fluxos de trabalho em repositórios e ambientes de desenvolvimento, mantendo o contexto consistente onde quer que trabalhem.

Experimente personalizar o Genie Code hoje mesmo

Instruções, Habilidades e Servidores MCP estão todos disponíveis ao usar o Genie Code no modo agente.

Para saber mais, confira a documentação do produto para Genie Code.

(Esta publicação no blog foi traduzida utilizando ferramentas baseadas em inteligência artificial) Publicação original