Grupo de comandos genie

Note

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. Consulte Agentes de Genie.

Pregunta Genie de Databricks

Haz una pregunta sobre datos y obtén una respuesta de Genie.

databricks genie ask QUESTION [flags]

Arguments

QUESTION

    La pregunta sobre datos que le hay que hacer al genio.

Options

--include-sql

    Mostrar consultas SQL ejecutadas por el agente. Se aplica a la salida de texto; La salida JSON siempre los incluye.

--raw

    Imprime eventos SSE en bruto en lugar de la salida renderizada.

-s, --session string

    ID de sesión (cualquier cadena) para continuar una conversación entre llamadas.

--warehouse-id string

    ID de almacén SQL. Se resuelve automáticamente si se omite.

Marcas globales

Examples

El siguiente ejemplo plantea una pregunta sobre datos:

databricks genie ask "What were total sales last month?"

El siguiente ejemplo plantea una pregunta con un almacén SQL específico:

databricks genie ask "Revenue by region" --warehouse-id 1234567890abcdef

El siguiente ejemplo continúa una conversación entre llamadas usando un ID de sesión que elijas:

databricks genie ask -s sales "What were total sales by quarter?"
databricks genie ask -s sales "Break that down by region"

Databricks genie crear-mensaje-comentar

Crea un comentario en un mensaje de conversación.

databricks genie create-message-comment SPACE_ID CONVERSATION_ID MESSAGE_ID CONTENT [flags]

Arguments

SPACE_ID

    El identificador asociado al espacio de Genie.

CONVERSATION_ID

    Identificador asociado a la conversación.

MESSAGE_ID

    El ID asociado al mensaje.

CONTENT

    Contenido de texto de comentarios.

Options

--json JSON

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

Marcas globales

Examples

El siguiente ejemplo crea un comentario en un mensaje:

databricks genie create-message-comment abc123 conv456 msg789 "Great analysis!"

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 agente 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 agente 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 agente de Genie:

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

Databricks Genie Delete-Conversation

Elimine una conversación de un agente de Genie.

databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    Identificador del agente 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 agente de Genie.

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

Arguments

SPACE_ID

    Identificador del agente 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

Databricks Genie Descargar-mensaje-adjunto-visualización

Descarga una imagen renderizada de un archivo adjunto de visualización de mensajes. Esto solo está disponible si el archivo adjunto es una visualización y el estado del mensaje está COMPLETADO.

databricks genie download-message-attachment-visualization NAME [flags]

Arguments

NAME

    El nombre del recurso adjunto a renderizar, en el formato spaces/{space_id}/conversations/{conversation_id}/messages/{message_id}/attachments/{attachment_id}.

Options

Marcas globales

Examples

El siguiente ejemplo descarga una visualización de archivo adjunto de mensaje:

databricks genie download-message-attachment-visualization "spaces/abc123/conversations/conv456/messages/msg789/attachments/attach001"

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. del agente 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 agente 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 agente de Genie.

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

Arguments

SPACE_ID

    Identificador del agente 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 agente 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

Obtenga una ejecución de evaluación para un agente de Genie.

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

Arguments

SPACE_ID

    Identificador del agente 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 agente 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 agente de Genie.

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

Arguments

SPACE_ID

    Identificador del agente 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 agente 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

    Identificador asociado al agente de Genie donde se encuentra 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. del agente 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 agente 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 agente de Genie.

databricks genie list-conversations SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del agente 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 lista-conversación-comentarios

Haz una lista de todos los comentarios en todos los mensajes de una conversación.

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

Arguments

SPACE_ID

    El identificador asociado al espacio de Genie.

CONVERSATION_ID

    Identificador asociado a la conversación.

Options

--page-size int

    Número máximo de comentarios por página.

--page-token string

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

Marcas globales

Examples

El siguiente ejemplo enumera todos los comentarios en una conversación:

databricks genie list-conversation-comments abc123 conv456

Databricks Genie lista-mensaje-comentarios

Haz una lista de comentarios en un mensaje de conversación específico.

databricks genie list-message-comments SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    El identificador asociado al espacio de Genie.

CONVERSATION_ID

    Identificador asociado a la conversación.

MESSAGE_ID

    El ID asociado al mensaje.

Options

--page-size int

    Número máximo de comentarios por página.

--page-token string

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

Marcas globales

Examples

El siguiente ejemplo enumera los comentarios sobre un mensaje:

databricks genie list-message-comments abc123 conv456 msg789

Databricks Genie List-Spaces

Enumerar agentes 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 agentes de Genie:

databricks genie list-spaces

Databricks Genie Enviar-Mensaje-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 agente 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 los detalles de un agente de Genie.

databricks genie get-space SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador asociado al agente de Genie.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtienen detalles de un agente 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 agente 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

Mueva un agente de Genie a la papelera.

databricks genie trash-space SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del agente de Genie que se va a papelera.

Options

Marcas globales

Examples

En el ejemplo siguiente se papelera un agente de Genie:

databricks genie trash-space abc123

Databricks Genie Update-Space

Actualizar un agente de Genie.

databricks genie update-space SPACE_ID [flags]

Arguments

SPACE_ID

    Identificador del agente 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 agente 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