Grupo de comandos genie

Note

Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks. La CLI de Databricks está en versión preliminar pública.

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

El genie grupo de comandos de la CLI de Databricks contiene comandos para Genie. Vea ¿Qué es un espacio de Genie?

databricks genie crear-mensaje

Cree un nuevo mensaje en una conversación. La respuesta de IA usa todos los mensajes creados anteriormente en la conversación para responder.

databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]

Arguments

SPACE_ID

    Identificador asociado al espacio de Genie donde se inicia la conversación.

CONVERSATION_ID

    Identificador asociado a la conversación.

CONTENT

    Contenido del mensaje de usuario.

Options

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--no-wait

    No espere a alcanzar el estado COMPLETED.

--timeout duration

    Cantidad máxima de tiempo para alcanzar el estado COMPLETED (valor predeterminado de 20m0s).

Marcas globales

Examples

En el ejemplo siguiente se crea un mensaje en una conversación:

databricks genie create-message abc123 conv456 "What were our sales last quarter?"

En el ejemplo siguiente se crea un mensaje con la configuración JSON:

databricks genie create-message abc123 conv456 "Show me top customers" --json '{"additional_context": "Include revenue data"}'

En el ejemplo siguiente se crea un mensaje sin esperar a que finalice:

databricks genie create-message abc123 conv456 "Analyze customer trends" --no-wait

databricks genie create-space

Cree un espacio de Genie.

databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]

Arguments

WAREHOUSE_ID

    Identificador del almacén de SQL que se va a asociar al espacio.

SERIALIZED_SPACE

    Configuración del espacio serializado.

Options

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

Marcas globales

Examples

En el ejemplo siguiente se crea un espacio de Genie:

databricks genie create-space my-warehouse-id '{}' --json @space-config.json

databricks genie delete-conversation

Elimina una conversación de un espacio de Genie.

databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

CONVERSATION_ID

    Identificador de la conversación que se va a eliminar.

Options

Marcas globales

Examples

En el ejemplo siguiente se elimina una conversación:

databricks genie delete-conversation abc123 conv456

databricks genie delete-conversation-message

Elimine un mensaje de una conversación en un espacio de Genie.

databricks genie delete-conversation-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

CONVERSATION_ID

    Identificador de la conversación.

MESSAGE_ID

    Identificador del mensaje que se va a eliminar.

Options

Marcas globales

Examples

En el ejemplo siguiente se elimina un mensaje:

databricks genie delete-conversation-message abc123 conv456 msg789

Ejecución de consulta de archivos adjuntos de mensajes en Databricks Genie

Ejecute el SQL para un adjunto de consulta de mensajes. Utilice este comando cuando el adjunto de la consulta haya expirado y necesite volverse a ejecutar.

databricks genie execute-message-attachment-query SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]

Arguments

SPACE_ID

    ID de espacio de Genie.

CONVERSATION_ID

    Id. de la conversación.

MESSAGE_ID

    ID de mensaje.

ATTACHMENT_ID

    ID de archivo adjunto.

Options

Marcas globales

Examples

En el ejemplo siguiente se ejecuta una consulta de datos adjuntos de mensaje:

databricks genie execute-message-attachment-query abc123 conv456 msg789 attach001

databricks genie generate-download-full-query-result

Genere una descarga para el resultado de la consulta completa de los datos adjuntos de un mensaje.

databricks genie generate-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

CONVERSATION_ID

    Identificador de la conversación.

MESSAGE_ID

    Identificador del mensaje.

ATTACHMENT_ID

    Identificador de los datos adjuntos.

Options

Marcas globales

Examples

En el ejemplo siguiente se genera una descarga para un resultado de consulta completo:

databricks genie generate-download-full-query-result abc123 conv456 msg789 attach001

databricks genie genie-create-eval-run

Cree una ejecución de evaluación para un espacio de Genie.

databricks genie genie-create-eval-run SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

Options

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

Marcas globales

Examples

En el ejemplo siguiente se crea una ejecución de evaluación:

databricks genie genie-create-eval-run abc123 --json @eval-config.json

databricks genie genie-get-eval-result-details

Obtenga los detalles de un resultado de evaluación.

databricks genie genie-get-eval-result-details SPACE_ID EVAL_RUN_ID RESULT_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

EVAL_RUN_ID

    Identificador de la ejecución de evaluación.

RESULT_ID

    Identificador del resultado de la evaluación.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtienen los detalles del resultado de la evaluación:

databricks genie genie-get-eval-result-details abc123 run456 result789

databricks genie genie-get-eval-run

Obtener una ejecución de evaluación para un espacio de Genie.

databricks genie genie-get-eval-run SPACE_ID EVAL_RUN_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

EVAL_RUN_ID

    Identificador de la ejecución de evaluación.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene una ejecución de evaluación:

databricks genie genie-get-eval-run abc123 run456

databricks genie genie-list-eval-results

Enumerar los resultados de la evaluación de una ejecución de evaluación.

databricks genie genie-list-eval-results SPACE_ID EVAL_RUN_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

EVAL_RUN_ID

    Identificador de la ejecución de evaluación.

Options

--page-size int

    Número máximo de resultados de valor para devolver por página.

--page-token string

    Token opaco para recuperar la siguiente página de resultados.

Marcas globales

Examples

En el ejemplo siguiente se enumeran los resultados de la evaluación:

databricks genie genie-list-eval-results abc123 run456

databricks genie genie-list-eval-runs

Enumera las ejecuciones de evaluación de un espacio de Genie.

databricks genie genie-list-eval-runs SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

Options

--page-size int

    Número máximo de ejecuciones de evaluación para devolver por página.

--page-token string

    Token para obtener la siguiente página de resultados.

Marcas globales

Examples

En el ejemplo siguiente se enumeran las ejecuciones de evaluación:

databricks genie genie-list-eval-runs abc123

databricks genie get-download-full-query-result

Obtenga la descarga de un resultado de consulta completo generado anteriormente.

databricks genie get-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID DOWNLOAD_ID DOWNLOAD_ID_SIGNATURE [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

CONVERSATION_ID

    Identificador de la conversación.

MESSAGE_ID

    Identificador del mensaje.

ATTACHMENT_ID

    Identificador de los datos adjuntos.

DOWNLOAD_ID

    Identificador de la descarga.

DOWNLOAD_ID_SIGNATURE

    Firma del identificador de descarga.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene una descarga completa de resultados de consulta:

databricks genie get-download-full-query-result abc123 conv456 msg789 attach001 dl001 sig001

databricks genie get-message

Obtener un mensaje de una conversación.

databricks genie get-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    El identificador asociado al espacio de Genie donde está ubicada la conversación de destino.

CONVERSATION_ID

    Identificador asociado a la conversación de destino.

MESSAGE_ID

    Identificador asociado al mensaje de destino de la conversación identificada.

Options

Marcas globales

Examples

En el ejemplo siguiente se recupera un mensaje de una conversación:

databricks genie get-message abc123 conv456 msg789

databricks genie obtener-resultado-de-consulta-de-adjunto-de-mensaje

Obtenga el resultado de la consulta SQL si el mensaje tiene datos adjuntos de consulta. Esto solo está disponible si un mensaje tiene datos adjuntos de consulta y el estado del mensaje es EXECUTING_QUERY o COMPLETED.

databricks genie get-message-attachment-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]

Arguments

SPACE_ID

    ID de espacio de Genie.

CONVERSATION_ID

    Id. de la conversación.

MESSAGE_ID

    ID de mensaje.

ATTACHMENT_ID

    ID de archivo adjunto.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene el resultado de la consulta para los datos adjuntos de un mensaje:

databricks genie get-message-attachment-query-result abc123 conv456 msg789 attach001

databricks genie list-conversation-messages

Enumerar mensajes en una conversación.

databricks genie list-conversation-messages SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

CONVERSATION_ID

    Identificador de la conversación.

Options

--page-size int

    Número máximo de mensajes que se van a devolver por página.

--page-token string

    Token para obtener la siguiente página de resultados.

Marcas globales

Examples

En el ejemplo siguiente se enumeran los mensajes de una conversación:

databricks genie list-conversation-messages abc123 conv456

databricks genie list-conversations

Enumera las conversaciones en un espacio de Genie.

databricks genie list-conversations SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

Options

--page-size int

    Número máximo de conversaciones que se van a devolver por página.

--page-token string

    Token para obtener la siguiente página de resultados.

Marcas globales

Examples

En el ejemplo siguiente se enumeran las conversaciones en un espacio:

databricks genie list-conversations abc123

databricks genie list-spaces

Enumere los espacios de Genie en el área de trabajo.

databricks genie list-spaces [flags]

Options

--page-size int

    Número máximo de espacios que se van a devolver por página.

--page-token string

    Token de paginación para obtener la siguiente página de resultados.

Marcas globales

Examples

En el ejemplo siguiente se enumeran todos los espacios de Genie:

databricks genie list-spaces

databricks genie send-message-feedback

Envíe comentarios sobre un mensaje en una conversación de Genie.

databricks genie send-message-feedback SPACE_ID CONVERSATION_ID MESSAGE_ID RATING [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie.

CONVERSATION_ID

    Identificador de la conversación.

MESSAGE_ID

    Identificador del mensaje.

RATING

    Clasificación de comentarios del mensaje.

Options

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

Marcas globales

Examples

En el ejemplo siguiente se envían comentarios positivos sobre un mensaje:

databricks genie send-message-feedback abc123 conv456 msg789 POSITIVE

databricks genie get-space

Obtenga detalles de un Genie Space.

databricks genie get-space SPACE_ID [flags]

Arguments

SPACE_ID

    El identificador asociado al espacio de Genie.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtienen detalles de un espacio de Genie:

databricks genie get-space abc123

databricks genie iniciar-conversación

Inicie una nueva conversación.

databricks genie start-conversation SPACE_ID CONTENT [flags]

Arguments

SPACE_ID

    Identificador asociado al espacio de Genie donde desea iniciar una conversación.

CONTENT

    Texto del mensaje que inicia la conversación.

Options

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--no-wait

    No espere a alcanzar el estado COMPLETED.

--timeout duration

    Cantidad máxima de tiempo para alcanzar el estado COMPLETED (valor predeterminado de 20m0s).

Marcas globales

Examples

En el ejemplo siguiente se inicia una nueva conversación:

databricks genie start-conversation abc123 "What are our top performing products this month?"

En el ejemplo siguiente se inicia una conversación con la configuración json:

databricks genie start-conversation abc123 "Show me sales data" --json '{"context": "Q4 2024"}'

En el ejemplo siguiente se inicia una conversación sin esperar a que finalice:

databricks genie start-conversation abc123 "Analyze customer behavior" --no-wait

databricks genie-space

Mueve un espacio de Genie a la papelera.

databricks genie trash-space SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie que se va a papelera.

Options

Marcas globales

Examples

En el ejemplo siguiente se papelera un espacio de Genie:

databricks genie trash-space abc123

databricks genie update-space

Actualizar un espacio de Genie.

databricks genie update-space SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del espacio de Genie que se va a actualizar.

Options

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

Marcas globales

Examples

En el ejemplo siguiente se actualiza un espacio de Genie:

databricks genie update-space abc123 --json '{"title": "Updated Space Title"}'

Marcas globales

--debug

  Indica si se va a habilitar el registro de depuración.

-h o --help

    Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado.

--log-file cadena

    Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.

--log-format formato

    Tipo de formato de registro: text o json. El valor predeterminado es text.

--log-level cadena

    Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado.

-o, --output tipo

    El tipo de salida del comando, ya sea text o json. El valor predeterminado es text.

-p, --profile cadena

    Nombre del perfil en el archivo ~/.databrickscfg para usarlo al ejecutar el comando. Si no se especifica esta marca, si existe, se usa el perfil denominado DEFAULT .

--progress-format formato

    Formato para mostrar los registros de progreso: default, append, inplaceo json

-t, --target cadena

    Si es aplicable, el objetivo del paquete que se va a usar