Tarea del Código Genie para trabajos

Usa la tarea Código Genie para ejecutar un agente autónomo como parte de un trabajo. Genie Code funciona con una instrucción en lenguaje natural y se ejecuta con aprobación automática.

Lo que hace la tarea de Genie Code

El tipo de tarea Genie Code inicia un nuevo chat de Genie Code con tu instrucción y genera una respuesta. Genie Code lee datos, llama a herramientas y actúa según tu indicación sin requerir intervención o aprobación adicional. Una vez que termine la partida, puedes abrir el chat y seguir interactuando con Código Genio.

Utiliza una tarea de Genie Code cuando quieras automatizar análisis complejos, operaciones de datos o toma de decisiones como parte de un trabajo programado. Por ejemplo:

  • Resume los resultados de los trabajos nocturnos y envíe un informe por correo electrónico.
  • Analizar los datos entrantes y señalar anomalías.
  • Investiga un ticket de Jira y propone una solución.
  • Genera una auditoría de cumplimiento semanal.

Requirements

  • Tus área de trabajo deben tener acceso a las capacidades de agente de Genie Code. Vea Requisitos.
  • La instrucción de tu tarea debe cumplir las políticas de uso de Genie Code.

Configurar una tarea de Genie Code

Note

La interfaz de usuario de trabajos muestra opciones dinámicamente basadas en otras opciones configuradas.

Para añadir una tarea de Código Genie:

  1. Vaya a la pestaña Tareas de la interfaz de usuario de trabajos.
  2. Haga clic en el icono Más.Agregar tarea.
  3. Escriba un nombre en el campo Nombre de tarea.
  4. En el menú desplegable Tipo, seleccione Genie Code.

Configura el prompt

Introduce un prompt en lenguaje natural en el campo de Prompt . El prompt describe lo que quieres que haga el agente cuando la tarea se ejecute. Por ejemplo:

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.

(Opcional) Utiliza parámetros y valores dinámicos en el prompt

Para reutilizar un prompt entre ejecuciones con valores diferentes, haz referencia a los valores en el prompt con llaves dobles ({{ }}). Cuando la tarea se ejecuta, Azure Databricks reemplaza cada referencia por su valor. El prompt admite:

  • Parámetros del trabajo: {{name}}, donde name es la clave del parámetro del trabajo. Defina los parámetros del trabajo usando Editar parámetros en la barra lateral Detalles del trabajo. Consulte Configuración de parámetros del trabajo.
  • Referencias de valores dinámicos: por ejemplo, {{job.id}}, {{job.start_time.iso_date}}, un valor establecido por una tarea upstream con {{tasks.<task_name>.values.<key>}}, o la entrada actual de una tarea For each con {{input}}. Consulte Referencias de valores dinámicos.

Por ejemplo, con un parámetro de trabajo llamado region y una tarea anterior llamada ingest que establece el valor de tarea table:

Summarize yesterday's sales in {{tasks.ingest.values.table}} for {{region}} and flag anomalies.

Cómo se gestionan las referencias:

  • Una referencia que la tarea no puede usar aparece en una advertencia bajo el prompt y se deja tal como se escribe, por ejemplo {{input}} fuera de una tarea For each, una referencia a una tarea que no está aguas arriba de esta tarea, o un nombre de tarea que debe escribirse entre acentos graves.
  • Un {{name}} marcador de posición sin un parámetro de trabajo coincidente se deja sin cambios.
  • Si un valor dinámico no puede resolverse cuando se ejecuta el trabajo, por ejemplo un valor de tarea que la tarea ascendente no ha configurado, la tarea falla antes de empezar.

Finalizar configuración del trabajo

  1. (Opcional) Para configurar reintentos, umbrales de tiempo de ejecución o trabajos pendientes de streaming, o notificaciones, consulte Configuración avanzada de tareas.
  2. Haga clic en Guardar tarea.

Para editar, clonar, deshabilitar o eliminar esta tarea, consulte Configuración y edición de tareas en trabajos de Lakeflow.

Cómo funcionan las tareas de trabajo en Genie Code

Ejecución autónoma con aprobación automática

Cuando se ejecuta una tarea de Código Genie, el agente ejecuta tu prompt de forma autónoma. La aprobación automática está siempre activada para las tareas del trabajo, por lo que no es necesario confirmar las llamadas a las herramientas durante la ejecución. El agente utiliza un clasificador de IA para comprobar cada acción con tu indicación y bloquea operaciones arriesgadas que quedan fuera del alcance previsto.

Para entender cómo funciona la autoaprobación y sus límites, consulta Aprobar acciones de la herramienta.

Warning

La aprobación automática es una función de productividad, no un límite de seguridad, y no puedes desactivarla para una tarea de trabajo. Como la tarea se ejecuta sin supervisión, piensa bien a qué datos de producción, espacios de trabajo sensibles o recursos compartidos puede acceder el prompt.

Lectura de los resultados de las tareas anteriores

El agente puede leer los resultados de las tareas anteriores del mismo trabajo como parte de su labor. Describe en tu prompt los datos de origen que quieres que utilice, y el agente recuperará los resultados relevantes de la tarea durante la ejecución.

Configuración del Código Genio y conexiones MCP

La tarea hereda la configuración de Genie Code y cualquier conexión personalizada de Model Context Protocol (MCP) que hayas configurado. El agente tiene acceso a las mismas herramientas y fuentes de datos que usarías en una sesión interactiva de Código Genio.

Output

Cada ejecución de una tarea produce un hilo de conversación de Genie Code que se puede continuar. Cuando la tarea termina, la salida Run muestra un enlace a la conversación, el prompt de la tarea y la respuesta del agente. Para una ejecución exitosa, la respuesta final muestra el mensaje final del agente. Si el mensaje es muy largo, la salida de la ejecución muestra la primera parte y la conversación mantiene el texto completo. Haz clic en Abrir conversación para revisar lo que hizo el agente, hacer preguntas de seguimiento o continuar el trabajo de forma interactiva.

Una tarea posterior puede usar la respuesta final de una ejecución exitosa con la referencia {{tasks.<task_name>.output.response}}de valor dinámico , por ejemplo, en un parámetro de tarea, una condición If/else o el prompt de otra tarea de Código Genie. Consulte Referencias de valores dinámicos.

Limitations

  • La autoaprobación no puede desactivarse: Las tareas del trabajo siempre se ejecutan con la autoaprobación activada. No puedes desactivarlo ni revisar acciones antes de que se ejecuten.

Recursos adicionales