Tâche Genie Code pour les jobs
Utilisez la tâche Genie Code pour exécuter un agent autonome dans le cadre d'un job. Genie Code fonctionne à partir d'une invite en langage naturel et s'exécute avec une approbation automatique.
Ce que fait la tâche Genie Code
Le type de tâche Genie Code lance un nouveau chat Genie Code avec votre prompt et produit une réponse. Genie Code lit les données, appelle des outils et agit selon votre prompt sans nécessiter d’entrée ou d’approbation supplémentaire. Une fois l’exécution terminée, vous pouvez ouvrir le chat et continuer à interagir avec Genie Code.
Utilisez une tâche Genie Code lorsque vous souhaitez automatiser des analyses complexes, des opérations de données ou la prise de décision dans le cadre d'un job planifié. Par exemple :
- Résumer les résultats du job qui a tourné la nuit et envoyer un rapport par e-mail.
- Analysez les données entrantes et signalez les anomalies.
- Enquêter sur un ticket Jira et proposer une correction.
- Générer un audit de conformité hebdomadaire.
Exigences
- Vos workspaces doivent avoir accès aux capacités agentiques de Genie Code. Voir Exigences.
- Votre prompt de tâche doit être conforme aux politiques d’utilisation de Genie Code.
Configurer une tâche Genie Code
L’interface utilisateur des jobs affiche les options de manière dynamique en fonction des autres paramètres configurés.
Pour ajouter une tâche Genie Code :
- Accédez à la Tasks tab dans l'interface utilisateur des jobs.
- Cliquez sur
Ajouter une tâche .
- Saisissez un nom dans le champ Nom de la tâche .
- Dans le menu déroulant Type , sélectionnez
Genie Code.
Configurer le prompt
Saisissez un prompt en langage naturel dans le champ Prompt . Le prompt décrit ce que vous souhaitez que l’agent fasse lors de l’exécution de la tâche. Par exemple :
Check the most recent results in the batch_errors table. If error_count is above 5, create a summary of the errors by type and severity, then post a summary to #data-ops Slack channel.
(Facultatif) Utiliser des paramètres et des valeurs dynamiques dans l’invite
Pour réutiliser une invite sur plusieurs exécutions avec des valeurs différentes, référencez les valeurs dans l’invite avec des doubles accolades ({{ }}). Lorsque la tâche s’exécute, Databricks remplace chaque référence par sa valeur. L’invite prend en charge :
- Parameter du Job :
{{name}}, oùnameest la clé du parameter du Job. Définissez les paramètres du job sur le job, en utilisant Modifier les paramètres dans la barre latérale Détails du job . Voir Configurer les parameter du Job. - Références de valeur dynamique : par exemple,
{{job.id}},{{job.start_time.iso_date}}, une valeur définie par une tâche en amont avec{{tasks.<task_name>.values.<key>}}, ou l’entrée actuelle d’une tâche Pour chaque avec{{input}}. Voir Références de valeur dynamique.
Par exemple, avec un parameter de job nommé region et une tâche en amont nommée ingest qui définit la valeur de tâche table:
Summarize yesterday's sales in {{tasks.ingest.values.table}} for {{region}} and flag anomalies.
Comment les références sont traitées :
- Une référence que la tâche ne peut pas utiliser est répertoriée dans un avertissement sous l’invite et laissée telle quelle, par exemple
{{input}}en dehors d’une tâche Pour chaque, une référence à une tâche qui n’est pas en amont de cette tâche, ou un nom de tâche qui doit être échappé avec des backticks. - Un espace réservé
{{name}}sans parameter de job correspondant reste inchangé. - Si une valeur dynamique ne peut pas être résolue lors de l’exécution du job, par exemple une valeur de tâche que la tâche en amont n’a pas définie, la tâche échoue avant son start.
Finaliser la configuration du job
- (Facultatif) Pour configurer les tentatives, les threshold de durée d’exécution ou de backlog de streaming, ou les notifications, consultez Paramètres de tâche avancés.
- Cliquez sur Enregistrer la tâche .
Pour modifier, cloner, désactiver ou supprimer cette tâche, consultez Configurer et modifier des tâches dans Lakeflow Jobs.
Fonctionnement des tâches de job Genie Code
Exécution autonome avec approbation automatique
Lorsqu'une tâche Genie Code s'exécute, l'agent exécute votre invite de manière autonome. L'approbation automatique est toujours activée pour les tâches de job ; vous n'avez donc pas à confirmer les appels d'outils pendant l'exécution. L'agent utilise un classificateur IA pour vérifier chaque action par rapport à votre invite et bloque les opérations risquées qui sortent du cadre prévu.
Pour comprendre le fonctionnement et les limites de l’approbation automatique, consultez Approuver les actions de l’outil.
L’approbation automatique est une fonctionnalité de productivité, et non une limite de sécurité ; vous ne pouvez pas la désactiver pour une tâche de job. Comme la tâche s’exécute sans surveillance, soyez vigilant quant aux données de production, aux Workspace sensibles ou aux ressources partagées auxquels le prompt peut accéder.
Lecture des résultats des tâches en amont
L’agent peut lire les sorties des tâches en amont au sein du même job dans le cadre de son travail. Décrivez les données en amont que vous souhaitez utiliser dans votre prompt, et l’agent récupérera les sorties de tâche pertinentes pendant l’exécution.
Paramètres de Genie Code et connexions MCP
La tâche hérite de vos paramètres Genie Code et de toutes les connexions personnalisées au protocole MCP (Model Context Protocol) que vous avez configurées. L’agent a accès aux mêmes outils et sources de données que ceux que vous utiliseriez dans une session interactive Genie Code.
Résultat
Chaque exécution de tâche génère un fil de conversation Genie Code qui peut être repris. Lorsque la tâche est terminée, la sortie de l’exécution affiche un lien vers la conversation, le prompt de la tâche et la réponse de l’agent. Pour une exécution réussie, la Réponse finale affiche le message final de l’agent. Si le message est très long, la sortie de l’exécution affiche la première partie et la conversation conserve le texte intégral. Cliquez sur Ouvrir la conversation pour consulter ce que l’agent a fait, poser des questions complémentaires ou poursuivre le travail de manière interactive.
Une tâche en aval peut utiliser la réponse finale d’une exécution réussie avec la référence de valeur dynamique {{tasks.<task_name>.output.response}}, par exemple dans un parameter de tâche, une condition Si/Sinon ou l’invite d’une autre tâche Genie Code. Voir Références de valeur dynamique.
Limitations
- L’approbation automatique ne peut pas être désactivée : les tâches de job s’exécutent toujours avec l’approbation automatique activée. Vous ne pouvez pas le désactiver ni examiner les actions avant leur exécution.
Ressources supplémentaires
- Configurer et modifier des tâches dans les Lakeflow Jobs: configurez et modifiez des tâches dans les Lakeflow Jobs.
- Fonctionnalités et capacités de Genie Code: découvrez comment utiliser Genie Code de manière générale.
- Tâches planifiées Genie Code: planifiez l’exécution récurrente de prompts Genie Code. Une tâche planifiée s’exécute de manière interactive et génère une discussion dans votre liste de discussions, tandis qu’une tâche de job Genie Code s’exécute dans le cadre d’un workflow de job.