Routine nel servizio Foundry Agent (anteprima)

Le routine nel Servizio agenti Foundry consentono di avviare automaticamente un agente quando si verifica un trigger predefinito. Usa una routine quando vuoi un modo integrato nel progetto per dire: "Quando viene raggiunta un'ora specifica, una pianificazione o si verifica un evento, invoca questo agente."

In assenza di procedure standard, i team spesso creano autonomamente questo livello di attivazione combinando tecnologie quali scheduler, App per la logica, Funzioni di Azure, code, archiviazione personalizzata e codice di autenticazione. Le routine trasferiscono quel collante operativo in Foundry, in modo che trigger, azioni, autorizzazioni, connessioni e cronologia delle esecuzioni risiedano insieme all'agente nello stesso progetto Foundry.

Usare routine per l'automazione leggera degli agenti, ad esempio riepiloghi giornalieri, promemoria monouso o controlli periodici. Se lo scenario richiede la diramazione, più agenti, passaggi di approvazione umana o stato complesso, usare invece un flusso di lavoro.

Contenuto di una routine

Una routine ha un attivatore e un'azione.

Il modello un trigger, un'azione concentra le procedure su un'unica domanda: quando deve essere eseguito questo agente? Non sostituisce l'orchestrazione. Quando sono necessarie più azioni, più agenti o logica condizionale, creare invece un flusso di lavoro. L'agente richiamato da una routine può implementare il proprio flusso di lavoro interno usando framework come Microsoft Agent Framework o LangGraph.

Tipi di trigger

Le routine supportano tre tipi di trigger nell'anteprima: timer, ricorrente ed evento. Il trigger ricorrente viene anche definito trigger ricorsivo.

Modalità di esecuzione delle routine

Quando si abilita una routine, Foundry gestisce automaticamente il trigger e il percorso di invio.

1. Il trigger si attiva tramite un timer, una schedulazione ricorrente o un evento esterno.
2. Foundry crea un registro delle esecuzioni di routine nel progetto.
3. Foundry richiama l'endpoint dell'agente configurato con l'input di routine.
4. L'agente elabora la richiesta usando il modello, le istruzioni, gli strumenti e l'identità configurati.
5. Foundry archivia lo stato di esecuzione della routine e collega l'esecuzione alla risposta dell'agente e ai dettagli della traccia.

Questo flusso usa il percorso di chiamata dell'agente esistente, quindi le routine non introducono un runtime separato per la logica dell'agente. L'agente continua a utilizzare la stessa configurazione, gli stessi strumenti e le stesse funzionalità di osservabilità che usa quando viene richiamato sia da un'applicazione sia da un playground.

Connessioni, identità e governance

Le routine sono limitate all'ambito di un progetto Foundry. Le routine vengono gestite con lo stesso modello di governance del progetto usato per agenti, strumenti e connessioni. Per altre informazioni, vedere controllo degli accessi basato su ruoli di Azure in Foundry.

I trigger di eventi usano connessioni di progetto per l'autenticazione al sistema esterno. Ad esempio, l'github_issue attivatore si basa su una connessione al connettore GitHub che Foundry configura nel namespace dei connettori del tuo account. Per altre informazioni, vedi Aggiungere server MCP gestiti basati sui namespace dei connettori.

Questa progettazione circoscritta al progetto offre i seguenti vantaggi:

• Nessuna risorsa di pianificazione separata da gestire: crea ed esegui routine da Foundry senza dover eseguire il provisioning di un'infrastruttura di automazione separata.
• Governance condivisa: applicare il controllo di accesso a livello di progetto alla gestione di routine e alla chiamata dell'agente.
• Esecuzioni osservabili: Esamina le esecuzioni di routine insieme alle risposte e alle tracce dell'agente che queste generano.

Non includere segreti, credenziali o token di accesso personali nell'input o nelle richieste di routine. Usare le connessioni di progetto e l'accesso basato su Microsoft Entra ID ovunque sia supportato.

Monitorare e gestire routine

Dopo aver creato una routine, usare la cronologia di esecuzione per comprendere cosa è successo ogni volta che il trigger è stato attivato. La cronologia di esecuzione consente di rispondere a domande operative come:

• L'attivatore si è attivato?
• Quale input è stato inviato all'agente?
• La chiamata dell'agente è stata completata o ha avuto esito negativo?
• Quale risposta ha prodotto l'agente?
• Quale traccia contiene le informazioni dettagliate su modello, strumento e latenza per tale chiamata?

È possibile sospendere una routine disabilitandola e riprendendola abilitandola di nuovo. È anche possibile aggiornare il trigger, l'azione o l'input per una routine esistente senza ricreare l'agente.

Promemoria pianificati dall'agente

Le routine avviano un agente tramite un attivatore esterno. Un agente ospitato può anche programmare sé stesso per eseguirsi nuovamente in seguito richiamando uno strumento di promemoria integrato che esponi tramite una toolbox. L'agente decide durante l'esecuzione di dover effettuare un follow-up, stabilisce il ritardo e il servizio invoca nuovamente l'agente nella stessa conversazione allo scadere del ritardo. Usa questo modello per follow-up guidati da agenti, ad esempio per ricontrollare un'attività di lunga durata. Per i passaggi, vedere Automatizzare gli agenti con routine.

Routine e flussi di lavoro

Le routine e i flussi di lavoro consentono entrambi di automatizzare gli scenari degli agenti, ma risolvono problemi diversi.

Usare prima una routine quando l'automazione è semplicemente "eseguire questo agente quando si verifica un evento". Passare ai flussi di lavoro quando l'automazione richiede logica di coordinamento oltre una singola chiamata dell'agente.

Limitazioni dell'anteprima

L'anteprima presenta le limitazioni seguenti:

• Una routine ha esattamente un attivatore e un'azione.
• L'unico tipo di azione è richiamare un agente Foundry.
• I tipi di trigger supportati sono trigger basati su timer, ricorrenti e basati su eventi (issue di GitHub).

Contenuti correlati

• Ciclo di vita di sviluppo dell'agente
• Crea un flusso di lavoro in Microsoft Foundry
• Automatizza gli agenti con routine
• Tracciamento degli agenti in Microsoft Foundry