Pular para o conteúdo principal
Última atualização em

Políticas de uso da Pesquisa de AI

info

Visualização

Esse recurso está em Prévia Pública.

Você pode aplicar uma política de uso a um endpoint ou índice de Pesquisa de IA para rastrear seus gastos serverless por equipe ou projeto.

Políticas de uso permitem aos administradores agrupar e filtrar registros de cobrança em todos os produtos serverless do Databricks e fornecem uma interface de usuário dedicada para acompanhamento de gastos. Políticas de uso são criadas por administradores de workspace e podem ser aplicadas a endpoints e índices de Pesquisa de AI. Para obter informações gerais e detalhes sobre como criar e gerenciar políticas de uso, consulte Uso de atributos com políticas de uso serverless.

Para obter informações gerais sobre como gerenciar seus custos ao usar a Pesquisa de IA, consulte guia de gerenciamento de custos da Pesquisa de IA.

Aplicar uma política de uso a um endpoint​

Você pode aplicar uma política de uso ao criar um endpoint, ou editar o endpoint mais tarde para aplicar uma política.

Aplicar política de uso na criação de endpoint​

Siga estes passos para criar um endpoint de Pesquisa de IA e aplicar uma política de uso:

  1. Na barra lateral esquerda, clique em Compute .

  2. Clique na **tab AI Search** e clique em **Criar**.

  3. Clique na seta à direita de **Configurações avançadas** para abrir essa seção da caixa de diálogo.

    Crie a caixa de diálogo do endpoint de Pesquisa de AI.

  4. Selecione uma política no menu **dropdown** **Política de Uso**.

  5. Clique em Confirmar .

Editar uma política de uso para um endpoint​

Para editar uma política de uso para um endpoint com a interface do usuário do Databricks:

  1. Na página do endpoint, clique no ícone de lápis.

    Ícone de lápis para editar políticas de uso na página do endpoint.

  2. Selecione uma política no menu suspenso e clique em Salvar .

Para editar uma política usando o SDK Python ou a API REST, consulte as tabs em Aplicar política de uso na criação do endpoint.

Aplicar uma política de uso a um índice​

É possível aplicar uma política de uso ao criar um índice, ou editar o índice posteriormente para aplicar uma política.

Aplicar política de uso na criação do índice​

Ao criar um índice de Pesquisa de AI na UI do Databricks, é possível selecionar uma política de uso no dropdown **Política de Uso** em **Configurações avançadas** na caixa de diálogo de criação do índice. Consulte Criar índice usando a interface do usuário.

Editar política de uso para um índice​

Para editar uma política de uso para um índice usando o SDK para Python:

Python
client.update_index_budget_policy(
    index_name="index_name",
    budget_policy_id="12345678-1234-1234-1234-1234567890ab",
)

Consultar gastos por política de uso​

Para consultar gastos por política de uso, é necessário possuir o ID da política de uso. Para obter o ID da política de uso usando a IU, siga estes passos como um usuário administrador:

  1. Clique no seu nome de usuário na barra superior do workspace do Databricks e clique em **Configurações**.
  2. Click compute .
  3. Ao lado de **políticas de uso serverless**, clique em **Gerenciar**.
  4. Selecione uma política de uso serverless. O ID da política de uso aparece na seção superior direita, **Sobre esta política**.

Para obter o ID da política de uso usando a API REST, consulte Listar políticas.

A seguinte consulta agrega gastos pelo ID da política de uso. Substituir <INSERT USAGE POLICY ID> pelo ID da política de uso.

SQL
WITH vector_search_usage_by_budget_policy (
 SELECT *,
        CASE WHEN usage_type = "STORAGE_SPACE" THEN 'storage'
             ELSE 'serving'
       END as workload_type
   FROM system.billing.usage
  WHERE billing_origin_product = 'VECTOR_SEARCH'
  AND usage_metadata.endpoint_name IS NOT NULL
  AND usage_metadata.budget_policy_id = '<INSERT USAGE POLICY ID>'
),
daily_usage_by_budget_policy AS (
 SELECT workspace_id,
      cloud,
      usage_date,
      workload_type,
      usage_metadata.endpoint_name as vector_search_endpoint,
      CASE WHEN workload_type = 'serving' THEN SUM(usage_quantity)
           ELSE null
           END as dbus,
      CASE WHEN workload_type = 'storage' THEN SUM(usage_quantity)
           ELSE null
           END as dsus
FROM vector_search_usage_by_budget_policy
GROUP BY all
ORDER BY 1,2,3,4,5,6 DESC
)
SELECT * FROM daily_usage_by_budget_policy

Limitações​

Para Pesquisa de AI, as políticas de uso têm as seguintes limitações:

  • Políticas de uso não impõem limites de gastos para AI Pesquisa.
Nesta página