Compito Codice Genie per i lavori

Usa il compito Genie Code per eseguire un agente autonomo come parte di un lavoro. Genie Code funziona a partire da un prompt in linguaggio naturale e viene eseguito con approvazione automatica.

Cosa fa l'attività Genie Code

Il tipo di attività Genie Code avvia una nuova chat di Genie Code con il tuo prompt e genera una risposta. Genie Code legge dati, chiama strumenti e agisce sul tuo prompt senza richiedere input o approvazione aggiuntiva. Una volta completata l'esecuzione, puoi aprire la chat e continuare a interagire con Genie Code.

Usa un compito Genie Code quando vuoi automatizzare analisi complesse, operazioni dati o decisioni come parte di un lavoro programmato. Per esempio:

• Riassumi i risultati dei lavori notturni e invia un rapporto via email.
• Analizza i dati in arrivo e segnala le anomalie.
• Indaga su un ticket di Jira e proponi una soluzione.
• Genera un audit settimanale di conformità.

Requirements

• I tuoi spazi di lavoro devono avere accesso alle capacità agentiche di Genie Code. Vedere Requisiti.
• Il prompt del tuo compito deve rispettare le politiche di utilizzo del Codice Genie.

Configura un'attività di Genie Code

Per aggiungere un compito Genie Code:

1. Vai alla scheda Attività nell'interfaccia utente Lavori.
2. Fare clic Aggiungere un'attività.
3. Immettere un nome nel campo Nome attività .
4. Nel menu a discesa Tipo selezionare Genie Code.

Configura il prompt

Inserisci un prompt in linguaggio naturale nel campo Prompt . Il prompt descrive cosa vuoi che l'agente faccia quando il compito viene eseguito. Per esempio:

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.

(Opzionale) Usa parametri e valori dinamici nel prompt

Per riutilizzare un prompt tra esecuzioni con valori diversi, si fa riferimento ai valori nel prompt con doppie parentesi graffe ({{ }}). Quando il task viene eseguito, Azure Databricks sostituisce ogni riferimento con il suo valore. Il prompt supporta:

• Parametri del lavoro: {{name}}, dove name è la chiave del parametro del lavoro. Definisci i parametri del lavoro nel processo, usando Modifica parametri nella barra laterale dei dettagli del lavoro. Consultare Configurare i parametri del processo.
• Riferimenti di valore dinamici: ad esempio, {{job.id}}, {{job.start_time.iso_date}}, un valore imposto da un compito a monte con {{tasks.<task_name>.values.<key>}}, oppure l'input corrente di un Per ogni compito con {{input}}. Vedere Riferimenti a valori dinamici.

Ad esempio, con un parametro del lavoro chiamato region e un task a monte chiamato ingest che imposta il valore tabledel compito :

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

Come vengono gestite le referenze:

• Un riferimento che il task non può usare è elencato in un avviso sotto il prompt e lasciato così com'è, ad esempio {{input}} all'esterno di un task For each, un riferimento a un task che non è a monte di questo, o un nome di task che deve essere delimitato da backtick.
• Un {{name}} segnaposto senza un parametro di lavoro corrispondente rimane invariato.
• Se un valore dinamico non può essere risolto quando il lavoro viene eseguito, ad esempio un valore di task che il task a monte non ha impostato, il task fallisce prima di iniziare.

Finalizzare la configurazione del lavoro

1. (Facoltativo) Per configurare i nuovi tentativi, i limiti per la durata di esecuzione o per il backlog dello streaming, oppure le notifiche, consulta Impostazioni avanzate dell'attività.
2. Fare clic su Salva attività.

Per modificare, clonare, disabilitare o eliminare questa attività, vedere Configurare e modificare le attività in Processi Lakeflow.

Come funzionano i compiti di lavoro di Genie Code

Esecuzione autonoma con approvazione automatica

Quando viene eseguito un compito Genie Code, l'agente esegue il tuo prompt in modo autonomo. L'approvazione automatica è sempre attiva per le attività del processo, quindi non devi confermare le chiamate degli strumenti durante l'esecuzione. L'agente utilizza un classificatore AI per confrontare ogni azione rispetto al tuo prompt e blocca operazioni rischiose che esescano dall'ambito previsto.

Per capire come funziona l'auto-approvazione e quali sono i suoi limiti, consulta Approvare le azioni dello strumento.

Lettura degli output dei task a monte

L'agente può leggere gli output dei compiti a monte nello stesso lavoro come parte del suo lavoro. Descrivi nel prompt i dati upstream che vuoi far utilizzare e l'agente recupererà gli output pertinenti del task durante l'esecuzione.

Impostazioni del Codice Genie e connessioni MCP

Il compito eredita le impostazioni del tuo codice Genie e qualsiasi connessione personalizzata Model Context Protocol (MCP) che hai configurato. L'agente ha accesso agli stessi strumenti e fonti di dati che useresti in una sessione interattiva di Codice Genio.

Risultato

Ogni esecuzione di un'attività produce un thread di conversazione di Genie Code che può essere continuato. Quando il compito si completa, l'output Run mostra un collegamento alla conversazione, il prompt del compito e la risposta dell'agente. Per un'esecuzione corretta, Final response mostra il messaggio finale dell'agente. Se il messaggio è molto lungo, l'output dell'esecuzione mostra la prima parte e la conversazione mantiene il testo completo. Clicca su Apri conversazione per rivedere cosa ha fatto l'agente, fare domande di approfondimento o proseguire il lavoro in modo interattivo.

Un task a valle può utilizzare la risposta finale di un'esecuzione riuscita con il riferimento {{tasks.<task_name>.output.response}}al valore dinamico , ad esempio in un parametro di task, una condizione If/else o il prompt di un altro task Genie Code. Vedere Riferimenti a valori dinamici.

Limitazioni

• L'auto-approvazione non può essere disabilitata: i compiti del lavoro si eseguono sempre con l'auto-approvazione attiva. Non puoi disattivarlo o rivedere le azioni prima che vengano eseguite.

Risorse aggiuntive

• Configura e modifica le attività nei Lakeflow Jobs: Configura e modifica le attività in Lakeflow Jobs.
• Caratteristiche e capacità di Genie Code: Impara a usare Genie Code in generale.
• Compiti programmati Codice Genie: Programmare i prompt Codice Genio per essere eseguiti in modo ricorrente. Un compito programmato viene eseguito in modo interattivo e genera una chat nella tua chat list, mentre un compito di lavoro Genie Code viene eseguito come parte di un flusso di lavoro di lavoro.