genie groupe de commande

Note

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le genie groupe de commandes dans l’interface CLI Databricks contient des commandes pour Genie. Voir Les agents Génie.

Databricks génie ask

Posez une question sur les données et obtenez une réponse de Genie.

databricks genie ask QUESTION [flags]

Arguments

QUESTION

    La question sur les données à poser au Génie.

Options

--include-sql

    Afficher les requêtes SQL exécutées par l’agent. S’applique à la sortie texte ; La sortie JSON les inclut toujours.

--raw

    Imprimez des événements SSE bruts au lieu de la sortie rendue.

-s, --session string

    ID de session (n’importe quelle chaîne) pour poursuivre une conversation entre appels.

--warehouse-id string

    ID d’entrepôt SQL. Résout automatiquement si c’est omis.

Indicateurs globaux

Examples

L’exemple suivant pose une question sur les données :

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

L’exemple suivant pose une question avec un entrepôt SQL spécifique :

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

L’exemple suivant poursuit une conversation entre appels en utilisant un identifiant de session que vous choisissez :

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

Databricks Genie créer-message-commenter

Créez un commentaire sur un message de conversation.

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

Arguments

SPACE_ID

    ID associé à l’espace Génie.

CONVERSATION_ID

    ID associé à la conversation.

MESSAGE_ID

    L’identifiant associé au message.

CONTENT

    Texte de commentaire.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant crée un commentaire sur un message :

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

databricks genie créer-message

Créez un message dans une conversation. La réponse IA utilise tous les messages créés précédemment dans la conversation pour répondre.

databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]

Arguments

SPACE_ID

    ID associé à l’agent Genie où la conversation est démarrée.

CONVERSATION_ID

    ID associé à la conversation.

CONTENT

    Contenu du message utilisateur.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--no-wait

    N’attendez pas d’atteindre l’état TERMINÉ.

--timeout duration

    Durée maximale d’atteindre l’état COMPLETED (20m0s par défaut).

Indicateurs globaux

Examples

L’exemple suivant crée un message dans une conversation :

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

L’exemple suivant crée un message avec la configuration JSON :

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

L’exemple suivant crée un message sans attendre la fin :

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

Databricks Genie create-space

Créez un agent Génie.

databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]

Arguments

WAREHOUSE_ID

    ID de l’entrepôt SQL à associer à l’espace.

SERIALIZED_SPACE

    Configuration de l’espace sérialisé.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant crée un Agent Genie :

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

Databricks Genie Delete-Conversation

Supprimez une conversation d’un Agent Génie.

databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation à supprimer.

Options

Indicateurs globaux

Examples

L’exemple suivant supprime une conversation :

databricks genie delete-conversation abc123 conv456

Databricks Génie delete-conversation-message

Supprimez un message d’une conversation dans un Agent Genie.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

MESSAGE_ID

    ID du message à supprimer.

Options

Indicateurs globaux

Examples

L’exemple suivant supprime un message :

databricks genie delete-conversation-message abc123 conv456 msg789

Databricks Genie téléchargement-message-joint-visualisation

Téléchargez une image rendue d’une pièce jointe à la visualisation d’un message. Cela n’est possible que si la pièce jointe est une visualisation et que l’état du message est TERMINÉ.

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

Arguments

NAME

    Le nom de la ressource de la pièce jointe à rendu, dans le format spaces/{space_id}/conversations/{conversation_id}/messages/{message_id}/attachments/{attachment_id}.

Options

Indicateurs globaux

Examples

L’exemple suivant télécharge une visualisation de pièce jointe à un message :

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

exécuter-requête-de-pièce-jointe-sur-databricks-genie

Exécutez le code SQL pour une pièce jointe de requête de message. Utilisez cette commande lorsque la pièce jointe de requête a expiré et doit être réexécutée.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

MESSAGE_ID

    ID du message.

ATTACHMENT_ID

    ID de pièce jointe.

Options

Indicateurs globaux

Examples

L’exemple suivant exécute une requête de pièce jointe de message :

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

Databricks Genie Generate-Download-full-Query-Result

Générez un téléchargement pour le résultat complet de la requête d’une pièce jointe de message.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

MESSAGE_ID

    ID du message.

ATTACHMENT_ID

    ID de la pièce jointe.

Options

Indicateurs globaux

Examples

L’exemple suivant génère un téléchargement pour un résultat de requête complet :

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

Databricks Genie Genie-create-eval-run

Créez une exécution d’évaluation pour un agent Génie.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant crée une exécution d’évaluation :

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

Databricks Genie Genie-get-eval-result-details

Obtenez des détails pour obtenir un résultat d’évaluation.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

EVAL_RUN_ID

    ID de l’exécution de l’évaluation.

RESULT_ID

    ID du résultat de l’évaluation.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient les détails du résultat d’évaluation :

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

Databricks Genie Genie-get-eval-run

Obtenez une exécution d’évaluation pour un agent Genie.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

EVAL_RUN_ID

    ID de l’exécution de l’évaluation.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient une exécution d’évaluation :

databricks genie genie-get-eval-run abc123 run456

Databricks Genie Genie-List-Eval-Results

Répertoriez les résultats de l’évaluation pour une exécution d’évaluation.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

EVAL_RUN_ID

    ID de l’exécution de l’évaluation.

Options

--page-size int

    Nombre maximal de résultats d’évaluation à retourner par page.

--page-token string

    Jeton opaque pour récupérer la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant répertorie les résultats d’évaluation :

databricks genie genie-list-eval-results abc123 run456

Databricks Genie Genie-list-eval-runs

Répertorier les exécutions d’évaluation d’un agent Genie.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

Options

--page-size int

    Nombre maximal d’exécutions d’évaluation à retourner par page.

--page-token string

    Jeton pour obtenir la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant répertorie les exécutions d’évaluation :

databricks genie genie-list-eval-runs abc123

Databricks Genie get-download-full-query-result

Obtenez le téléchargement pour un résultat de requête complet généré précédemment.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

MESSAGE_ID

    ID du message.

ATTACHMENT_ID

    ID de la pièce jointe.

DOWNLOAD_ID

    ID du téléchargement.

DOWNLOAD_ID_SIGNATURE

    Signature de l’ID de téléchargement.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient un téléchargement complet du résultat de requête :

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

databricks genie obtenir-message

Recevez un message depuis une conversation.

databricks genie get-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    ID associé à l’Agent Genie où se trouve la conversation cible.

CONVERSATION_ID

    ID associé à la conversation cible.

MESSAGE_ID

    ID associé au message cible de la conversation identifiée.

Options

Indicateurs globaux

Examples

L’exemple suivant récupère un message d’une conversation :

databricks genie get-message abc123 conv456 msg789

Databricks Genie get-message-attachment-query-result

Obtenez le résultat de la requête SQL si le message a une pièce jointe de requête. Ceci n’est disponible que si un message a une pièce jointe de requête et que l’état du message est EXECUTING_QUERY ou COMPLETED.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

MESSAGE_ID

    ID du message.

ATTACHMENT_ID

    ID de pièce jointe.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient le résultat de la requête pour une pièce jointe de message :

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

Databricks Genie List-Conversation-Messages

Répertorier les messages d’une conversation.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

Options

--page-size int

    Nombre maximal de messages à retourner par page.

--page-token string

    Jeton pour obtenir la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant répertorie les messages d’une conversation :

databricks genie list-conversation-messages abc123 conv456

Databricks Genie List-Conversations

Répertorier les conversations dans un Agent Génie.

databricks genie list-conversations SPACE_ID [flags]

Arguments

SPACE_ID

    ID de l’agent Génie.

Options

--page-size int

    Nombre maximal de conversations à retourner par page.

--page-token string

    Jeton pour obtenir la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant répertorie les conversations dans un espace :

databricks genie list-conversations abc123

Databricks Genie Liste-Conversation-Commentaires

Listez tous les commentaires dans tous les messages d’une conversation.

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

Arguments

SPACE_ID

    ID associé à l’espace Génie.

CONVERSATION_ID

    ID associé à la conversation.

Options

--page-size int

    Nombre maximal de commentaires à retourner par page.

--page-token string

    Jeton de pagination pour obtenir la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant liste tous les commentaires d’une conversation :

databricks genie list-conversation-comments abc123 conv456

Databricks Genie Liste-Message-Commentaires

Listez les commentaires sur un message de conversation spécifique.

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

Arguments

SPACE_ID

    ID associé à l’espace Génie.

CONVERSATION_ID

    ID associé à la conversation.

MESSAGE_ID

    L’identifiant associé au message.

Options

--page-size int

    Nombre maximal de commentaires à retourner par page.

--page-token string

    Jeton de pagination pour obtenir la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant liste les commentaires sur un message :

databricks genie list-message-comments abc123 conv456 msg789

Databricks Genie List-Spaces

Répertoriez les agents Genie dans l’espace de travail.

databricks genie list-spaces [flags]

Options

--page-size int

    Nombre maximal d’espaces à retourner par page.

--page-token string

    Jeton de pagination pour obtenir la page suivante des résultats.

Indicateurs globaux

Examples

L’exemple suivant répertorie tous les agents Genie :

databricks genie list-spaces

Databricks Genie Envoyer-Message-Feedback

Envoyez des commentaires sur un message dans une conversation Génie.

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

Arguments

SPACE_ID

    ID de l’agent Génie.

CONVERSATION_ID

    ID de la conversation.

MESSAGE_ID

    ID du message.

RATING

    Évaluation des commentaires pour le message.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant envoie des commentaires positifs sur un message :

databricks genie send-message-feedback abc123 conv456 msg789 POSITIVE

databricks genie obtenir-espace

Obtenez les détails d’un Agent Génie.

databricks genie get-space SPACE_ID [flags]

Arguments

SPACE_ID

    ID associé à l’agent Genie.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient les détails d’un Agent Genie :

databricks genie get-space abc123

databricks genie démarrer la conversation

Démarrez une nouvelle conversation.

databricks genie start-conversation SPACE_ID CONTENT [flags]

Arguments

SPACE_ID

    ID associé à l’agent Genie dans lequel vous souhaitez démarrer une conversation.

CONTENT

    Texte du message qui démarre la conversation.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--no-wait

    N’attendez pas d’atteindre l’état TERMINÉ.

--timeout duration

    Durée maximale d’atteindre l’état COMPLETED (20m0s par défaut).

Indicateurs globaux

Examples

L’exemple suivant démarre une nouvelle conversation :

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

L’exemple suivant démarre une conversation avec la configuration JSON :

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

L’exemple suivant démarre une conversation sans attendre la fin :

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

databricks génie- espace corbeille

Déplacez un Agent Génie vers la corbeille.

databricks genie trash-space SPACE_ID [flags]

Arguments

SPACE_ID

    ID de l’Agent Génie à corbeille.

Options

Indicateurs globaux

Examples

L’exemple suivant corbeille un Agent Genie :

databricks genie trash-space abc123

Databricks Genie Update-Space

Mettez à jour un agent Génie.

databricks genie update-space SPACE_ID [flags]

Arguments

SPACE_ID

    ID de l’agent Genie à mettre à jour.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant met à jour un Agent Genie :

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

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format Format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

    Nom du profil dans le ~/.databrickscfg fichier à utiliser pour exécuter la commande. Si cet indicateur n’est pas spécifié, s’il existe, le profil nommé DEFAULT est utilisé.

--progress-format Format

    Format d’affichage des journaux d’activité de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser