Criar um Genie Clean Room

info

Beta

Este recurso está em Beta. Os administradores de account podem gerenciar o acesso a este recurso na página Previews do console da account. Consulte Gerenciar prévias em nível de account.

Uma Genie Clean Room permite que um provedor de dados compartilhe um Genie Agent com um destinatário em outra organização. O destinatário faz perguntas ao agente em linguagem natural e obtém respostas sobre os dados do provedor, sem ver as instruções do agente ou os dados brutos.

Para saber mais sobre Genie Agents, consulte Genie Agents. Para uma visão geral de clean rooms, consulte O que é o Databricks Clean Rooms?.

Por que usar um Genie Clean Room?

Compartilhe com segurança os seus agentes Genie selecionados com os seus clientes, sem permitir que eles acessem os dados subjacentes, o contexto ou a propriedade intelectual proprietária:

• Compartilhe agentes, não dados : Os clientes podem usar seus agentes sem ver os dados e o contexto subjacentes.
• Combine datasets : os clientes podem trazer seus próprios dados e obter percepções da combinação de ambos os datasets.
• Governar o uso : Defina um limite diário de prompts. Os clientes não podem fazer download em massa das saídas do agente.

Como funcionam as Salas Limpas Genie

Quando você cria a sala limpa, o Databricks compartilha seu Genie Agent e todas as suas instruções na sala limpa central, juntamente com as tabelas, views e volumes que o agente referencia. O destinatário conversa com o agente na tab Chat na página de detalhes da sala limpa. As queries são executadas na sala limpa central, não no workspace de nenhum dos colaboradores.

A tabela a seguir compara o que cada colaborador pode fazer em uma Genie Clean Room:

Capacidade	Provedor	Destinatário
Anexar e sincronizar o Genie Agent	Sim	Não
Defina o limite diário de prompts	Sim	Não
view as instruções e exemplos do agente	Sim	Não
Adicionar ativos de dados	Não (os dados não podem ser adicionados através do clean room, apenas do Genie Agent)	Sim
Faça perguntas ao agente	Não	Sim

Capacidade	Provedor	Destinatário
Anexar e sincronizar o Genie Agent	Sim	Não
Defina o limite diário de prompts	Sim	Não
view as instruções e exemplos do agente	Sim	Não
Adicionar ativos de dados	Não (os dados não podem ser adicionados através do clean room, apenas do Genie Agent)	Sim
Faça perguntas ao agente	Não	Sim

O destinatário pode view os nomes das tabelas e os metadados das colunas do provedor. A interface do clean room não mostra ao destinatário valores de amostra ou conteúdo da tabela, mas é possível que o agente retorne valores em nível de linha se o destinatário solicitar. Todos os downloads estão desabilitados, portanto, o destinatário não pode exportar em massa a saída do agente. O provedor não pode ver nenhum ativo de dados que o destinatário adicionar, incluindo seus nomes.

O provedor view as instruções e exemplos do agente em Instruções do Genie Agent na tab Visão geral da clean room. O destinatário vê um aviso de que as instruções estão ocultas e não pode adicionar suas próprias instruções.

Se o provedor atualizar o Genie Agent em seu workspace, o destinatário não verá as alterações até que o provedor as sincronize. Consulte Sincronizar alterações com o Genie Agent.

Ao contrário de uma sala limpa em pacote, onde um consumidor faz a execução dos Notebooks ou JAR do provedor, uma sala limpa Genie não faz execução de Notebooks ou JAR.

Requisitos

• Seu workspace cumpre os requisitos para clean rooms. Consulte Requisitos.

• Um administrador de account tanto para o provedor quanto para o destinatário ativou a prévia do Genie Clean Room na página Previews do console da account. Consulte Gerenciar prévias no nível da account.

• Para criar a sala limpa, o provedor deve ter:

  • O privilégio CREATE CLEAN ROOM no metastore.
  • Permissão CAN EDIT no Genie Agent que eles desejam compartilhar.
  • SELECT em cada view de tabela e métrica, e READ VOLUME em cada volume, aos quais o Genie Agent faz referência.
  • USE CATALOG e USE SCHEMA nos catálogos e esquemas que contêm esses ativos.
  • O identificador de compartilhamento do Clean Room do destinatário. Consulte O passo 1. Solicitar o identificador de compartilhamento do colaborador.

• Para adicionar seus próprios dados à sala limpa, o destinatário deve ser o proprietário da sala limpa ou ter o privilégio MODIFY CLEAN ROOM nela, e deve ter SELECT em qualquer tabela ou view e READ VOLUME em qualquer volume que adicionar, mais USE CATALOG e USE SCHEMA nos catálogos e esquemas que os contêm.

• Para fazer perguntas ao agente, o destinatário deve ter o privilégio EXECUTE CLEAN ROOM TASK no clean room.

Práticas recomendadas

A Databricks recomenda o seguinte ao criar um Genie Clean Room:

• Conclua a curadoria antes de compartilhar : reveja as instruções e os exemplos do agente em seu workspace antes de criar o clean room, porque a experiência do destinatário depende deles.
• Mantenha o agente focado : Faça referência apenas às tabelas, views e volumes de que o destinatário precisa e mantenha o agente dentro do limite de tamanho. Consulte Limitações.
• Comece com um limite de prompt conservador : Para um teste ou avaliação, defina um limite diário baixo e aumente-o mais tarde.
• Sincronizar após cada alteração : As alterações que você faz no agente em seu workspace não chegam ao clean room até que você sincronize.

Criar um Clean Room de Genie

Execute os seguintes passos como provedor.

Obter o identificador de compartilhamento do destinatário

Peça ao destinatário o seu identificador de compartilhamento do Clean Room. Eles podem encontrá-lo usando as instruções em Encontrar seu identificador de compartilhamento.

Criar o clean room

1. No seu workspace do Databricks, clique em Catálogo .

2. Clique no botão Clean Rooms > .

3. Clique em Criar Clean Room .

4. Em Tipo de sala limpa , selecione Sala limpa Genie .

5. Em Nome da Clean Room , insira um nome para a clean room.

   O nome não pode usar espaços, pontos ou barras (/), e você não pode alterá-lo depois de criar o clean room.

6. Em Região , selecione a cloud e a região do clean room central. Consulte Disponibilidade regional.

7. Em Identificador de compartilhamento de Clean Room , insira o identificador de compartilhamento do destinatário.

   Você não pode alterar os colaboradores depois de criar o clean room.

8. Em Genie Agent , procure e selecione o Genie Agent a ser compartilhado. Você não pode substituí-lo por um agente diferente posteriormente.

9. Clique em Criar clean room .

Definir o limite diário de prompts

1. Na página de detalhes do clean room, clique na tab Controles de Saída .
2. Em Prompts permitidos por dia , insira o número máximo de prompts que o destinatário pode enviar por dia.
3. Clique em Salvar .

Cada mensagem que o destinatário envia e cada resposta que ele regenera conta como um prompt. A contagem faz Reset à meia-noite UTC. O destinatário pode view o limite na tab Controles de Saída , mas não pode alterá-lo.

Sincronizar alterações no Genie Agent

Ao alterar o Genie Agent no seu workspace, sincronize o clean room para compartilhar as alterações com o destinatário. A sincronização atualiza as instruções, exemplos e tabelas, views e volumes referenciados do agente no clean room. Isso não altera nem remove os ativos de dados que o destinatário adicionou.

1. Na página de detalhes do clean room, clique na tab Visão geral .
2. Na seção Genie Agent do painel direito, clique em Sincronizar Genie Agent .

Usar uma Clean Room Genie

Conclua os passos seguintes como destinatário.

Abrir a clean room

1. No seu workspace do Databricks, clique em Catálogo .
2. Clique no botão Clean Rooms > .
3. Clique no nome do clean room que o provedor compartilhou com você.

O clean room abre na tab Chat , onde você conversa com o Genie Agent do provedor. Para view os nomes das tabelas do provedor, clique na tab Visão Geral .

Adicione os seus próprios dados (opcional)

Para permitir que o agente combine seus dados com os do provedor, adicione suas tabelas, views, metric views, tabelas de transmissão, foreign tables ou volumes do Unity Catalog ao clean room. O agente pode query seus dados juntamente com os dados do provedor. O provedor não consegue ver os ativos que você adiciona, incluindo seus nomes.

1. Na página de detalhes do clean room, clique na tab Visão geral .
2. Clique em Adicionar ativos de dados .
3. Selecione os ativos de dados para adicionar, revise seus apelidos e clique em Salvar .

Para detalhes sobre a seleção de ativos e aliases, consulte O passo 3. Adicionar ativos de dados e notebooks à clean room. Para as permissões necessárias, consulte Requisitos. Você não pode adicionar notebooks, JARs ou modelos a um Genie Clean Room.

Fazer perguntas

Na tab Chat , insira uma pergunta em linguagem natural ou clique em uma das perguntas sugeridas. O agente responde usando as instruções do provedor e os dados da clean room. Para view conversas anteriores, clique no ícone de história.

O canto superior direito do chat mostra quantos prompts você tem disponíveis hoje, do limite diário do provedor. Se você atingir o limite diário de prompt do provedor, o chat mostrará a seguinte mensagem até a meia-noite UTC:

Text

You've reached this Genie clean room's limit of {limit} prompts per day. Please wait until the next UTC day before asking another question.

Limitações

• Uma Clean Room Genie tem exatamente dois colaboradores: o provedor e um recipiente. O colaborador que cria a clean room é o provedor.

• Uma clean room só pode ter um Genie Agent, e você não pode substituí-lo por um agente diferente.

• As salas limpas Genie suportam apenas o modo de chat. O modo de agente não é suportado.

• Não é possível adicionar ou sincronizar um Genie Agent que faça referência a qualquer um dos seguintes: O agente pode usar essas fontes em seu workspace, mas elas não podem ser compartilhadas em uma sala limpa:

  • Tabelas nos catálogos system ou samples.
  • Tabelas em um esquema information_schema.
  • Tabelas que você recebeu por meio do OpenSharing, incluindo tabelas do Databricks Marketplace.

• As tabelas às quais o Genie Agent faz referência de diferentes catalogos não podem compartilhar o mesmo nome schema.table.

• O provedor não consegue view as conversas do destinatário.

• Os receptores não podem fazer upload de arquivos no chat do clean room.

• Os destinatários não podem adicionar suas próprias instruções ao Genie Agent.

• Se a definição do Genie Agent for maior que 262.000 bytes quando compactada, o clean room não poderá compartilhá-la. Reduza o número de instruções ou queries de exemplo.

• Um Genie Agent criado a partir de uma integração, como o Catalog Explorer, não pode ser compartilhado em uma clean room.

• As respostas em linguagem natural ainda podem revelar informações sobre os dados do provedor. O Databricks não aplica limites de agregação nem limita o tamanho das respostas nas Clean Rooms do Genie.

• Os prompts e as conversas do destinatário não são registrados na tabela de eventos de clean room ou em logs de auditoria. Quando o provedor anexa ou sincroniza o agente ou altera o limite de prompt, os logs de auditoria registram os eventos createCleanRoomAsset ou updateCleanRoomAsset. Consulte Eventos de clean room.

Outros recursos

• • Genie Agents
  • Construa e faça a curadoria do Genie Agent que você compartilha, incluindo suas instruções e exemplos de queries.
• • Trabalhe com clean rooms do Databricks como um colaborador convidado
  • Encontre seu identificador de compartilhamento e trabalhe em uma clean room que outra organização compartilhou com você.