Creare un flusso di lavoro in Microsoft Foundry (anteprima)

I flussi di lavoro sono strumenti basati sull'interfaccia utente in Microsoft Foundry. Usarli per creare sequenze dichiarative e predefinite di azioni che orchestrano agenti e logica di business in un generatore visivo.

I flussi di lavoro consentono di creare sistemi di automazione intelligenti che combinano facilmente gli agenti di intelligenza artificiale con i processi aziendali in modo visivo. I sistemi a agente singolo tradizionali sono limitati nella loro capacità di gestire attività complesse e multifatta. Orchestrando più agenti, ognuno basato su un modello Foundry con competenze o ruoli specializzati, è possibile creare sistemi più affidabili, adattivi e in grado di risolvere in modo collaborativo i problemi reali.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea un account gratuito Azure, che include una sottoscrizione di valutazione gratuita.
• Progetto in Microsoft Foundry. Per altre informazioni, vedere Creare progetti.
• Accesso per creare ed eseguire flussi di lavoro nel progetto Foundry. Per ulteriori informazioni, fare riferimento a Controllo degli accessi in base al ruolo in Foundry.

Decidere quando usare i flussi di lavoro

I flussi di lavoro sono ideali per gli scenari in cui è necessario:

• Coordinare più agenti in un processo ripetibile.
• Aggiungere la logica di diramazione (ad esempio, if/else) e la gestione delle variabili senza scrivere codice.
• Creare passaggi umani nel ciclo (ad esempio, approvazioni o chiarimenti).

Per modificare il flusso di lavoro YAML in Visual Studio Code o eseguire flussi di lavoro in un playground locale, vedere:

• Lavora con i workflow dichiarativi (low-code) degli agenti in Visual Studio Code
• Lavora con i flussi di lavoro degli agenti ospitati (Pro-code) in Visual Studio Code

Informazioni sui modelli del flusso di lavoro

Foundry fornisce modelli per modelli di orchestrazione comuni. Iniziare con un flusso di lavoro vuoto o selezionare un modello:

Per ulteriori informazioni, vedere le orchestrazioni del flusso di lavoro di Microsoft Agent Framework.

Creare un flusso di lavoro

Questa procedura illustra come creare un flusso di lavoro sequenziale. Gli stessi passaggi generali si applicano ad altri tipi di flusso di lavoro.

1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia attivato. Questi passaggi fanno riferimento a Foundry (nuovo).These steps refer to Foundry (new).

   

2. Nel menu in alto a destra selezionare Compila.

3. Selezionare Crea nuovo flusso di lavoro>Sequenziale.

4. Assegnare un agente ai nodi dell'agente selezionando ogni nodo agente nel flusso di lavoro e selezionando l'agente desiderato o creando uno nuovo. Per altre informazioni, vedere Aggiungere agenti più avanti in questo articolo.

5. Selezionare Salva nel visualizzatore per salvare le modifiche.

   Importante

   Foundry non salva automaticamente i flussi di lavoro. Selezionare Salva dopo ogni modifica per mantenere il lavoro.

6. Selezionare Esegui flusso di lavoro.

7. Interagire con il flusso di lavoro nella finestra della chat.

8. Facoltativamente, aggiungere nuovi nodi al flusso di lavoro. La sezione successiva di questo articolo fornisce informazioni sui nodi.

Verificare l'esecuzione del flusso di lavoro

Dopo aver selezionato Esegui flusso di lavoro, verificare che:

• Ogni nodo viene completato nel visualizzatore.
• Nella finestra di chat sono visualizzate le risposte previste.
• Tutte le variabili salvate (ad esempio, l'output JSON da un nodo dell'agente) contengono i valori previsti.

Aggiungere nodi

I nodi sono i blocchi predefiniti del flusso di lavoro. Ogni nodo esegue un'azione specifica in sequenza.

I tipi di nodo comuni includono:

• Agente: richiamare un agente.
• Logica: usare if/else, passare a o per ognuno.
• Trasformazione dati: impostare una variabile o analizzare un valore.
• Chat di base: inviare un messaggio o porre una domanda a un agente.

Quando si seleziona un flusso di lavoro predefinito, il generatore visualizza i nodi in sequenza. Per riordinare i nodi, selezionare i tre puntini in un nodo e quindi selezionare Sposta. Per aggiungere nodi, selezionare l'icona del segno più (+) nell'area di lavoro.

Aggiungere agenti

Aggiungi ogni agente Foundry dal tuo progetto al flusso di lavoro. I nodi agente consentono anche di creare nuovi agenti con funzionalità personalizzate configurando il modello, la richiesta e gli strumenti.

Per le opzioni avanzate di creazione dell'agente, passare alla scheda Agente foundry nel portale di Foundry.

Aggiungere un agente esistente

1. Nel visualizzatore del flusso di lavoro selezionare il segno più.

2. Nell'elenco a discesa selezionare Richiama agente.

3. Nella finestra Crea nuovo agente selezionare esistente.

4. Immettere il nome dell'agente per cercare gli agenti esistenti nel progetto Foundry.

5. Selezionare l'agente desiderato per aggiungerlo al flusso di lavoro.

Creare un nuovo agente

1. Nel visualizzatore del flusso di lavoro selezionare il segno più.

2. Nell'elenco a discesa selezionare Richiama agente.

3. Immettere un nome dell'agente e una descrizione delle operazioni che l'agente esegue.

4. Selezionare Aggiungi.

5. Nella finestra Richiamare un agente configurare l'agente.

6. Selezionare Salva.

Configurare un formato di risposta di output

Per configurare un agente per restituire l'output JSON strutturato:

1. Nella finestra Invoke agent configuration (Richiama la configurazione dell'agente ) selezionare Create a new agent (Crea un nuovo agente).

2. Configurare l'agente per inviare l'output come schema JSON:

   1. Selezionare Dettagli.
   2. Selezionare l'icona del parametro.
   3. Per Formato testo selezionare Schema JSON.

   

3. Copiare lo schema JSON desiderato e incollarlo nella finestra Aggiungi formato risposta . Lo screenshot seguente mostra un esempio matematico. Selezionare Salva.

   

{
  "name": "math_response",
  "schema": {
    "type": "object",
    "properties": {
      "steps": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "explanation": {
              "type": "string"
            },
            "output": {
              "type": "string"
            }
          },
          "required": [
            "explanation",
            "output"
          ],
          "additionalProperties": false
        }
      },
      "final_answer": {
        "type": "string"
      }
    },
    "additionalProperties": false,
    "required": [
      "steps",
      "final_answer"
    ]
  },
  "strict": true
}

1. Selezionare Impostazioni azione. Selezionare quindi Salva output json_object/json_schema con nome.

2. Selezionare Crea nuova variabile. Scegliere un nome di variabile e quindi selezionare Fine.

   

Configurare funzionalità aggiuntive

• Visualizzazione visualizzatore YAML: impostare l'interruttore Visualizzazione visualizzatore YAML su Sì per archiviare il flusso di lavoro come file YAML. Modificare nel visualizzatore o nella visualizzazione YAML. Il salvataggio crea una nuova versione con cronologia delle versioni completa.

  Sia il visualizzatore che YAML sono modificabili. Le modifiche apportate al file YAML vengono visualizzate immediatamente nel visualizzatore.

• Controllo delle versioni: ogni salvataggio crea una nuova versione non modificabile. Per visualizzare la cronologia delle versioni o eliminare le versioni precedenti, aprire l'elenco a discesa Versione a sinistra del pulsante Salva .

• Note: aggiungere note al visualizzatore del flusso di lavoro per un contesto aggiuntivo. Nell'angolo superiore sinistro del visualizzatore selezionare Aggiungi nota.

Creare espressioni con Power Fx

Power Fx è un linguaggio a basso codice che usa formule simili a Excel. Usare Power Fx per creare una logica complessa che consenta agli agenti di modificare i dati. Ad esempio, una formula di Power Fx può impostare un valore di variabile, analizzare una stringa o valutare una condizione. Per altre informazioni, vedere panoramica di Power Fx e informazioni di riferimento sulle formule.

Usare le variabili in una formula

Per usare una variabile in una formula di Power Fx, è necessario aggiungere un prefisso al nome per indicare l'ambito della variabile:

• Per le variabili di sistema, usare System.
• Per le variabili locali, usare Local.

Ecco le variabili di sistema:

Usare valori letterali in una formula

Oltre a usare le variabili in una formula Power Fx, è possibile immettere valori letterali. Per usare un valore letterale in una formula, è necessario immetterlo nel formato corrispondente al tipo.

La tabella seguente elenca i tipi di dati e il formato dei valori letterali corrispondenti:

Formule comuni di Power Fx

Nella tabella seguente sono elencate le formule di Power Fx che è possibile usare con ogni tipo di dati.

Impostare una variabile con Power Fx

Questo esempio illustra come archiviare e restituire il nome di un cliente in lettere maiuscole:

1. Creare un flusso di lavoro e aggiungere un nodo Porre una domanda .

2. Nel riquadro visualizzato, nella casella Porre una domanda immettere Qual è il nome? o un altro messaggio. Nella casella Salva risposta utente come immettere un nome di variabile; ad esempio . Var01 Selezionare quindi Fine.

   

3. Aggiungere un'azione Invia messaggio . Nel riquadro visualizzato, nell'area Messaggio da inviare immettere {Upper(Local.Var01)}. Selezionare quindi Fine.

   

4. Selezionare Anteprima.

5. Nel riquadro di anteprima inviare un messaggio all'agente per richiamare il flusso di lavoro.

   

Creare flussi if/else con Power Fx

Questo esempio illustra come aggiungere un flusso if/else e compilare una condizione con variabili di sistema.

1. Creare un flusso di lavoro e aggiungere un nodo Porre una domanda .

2. Selezionare l'icona + e aggiungere un flusso if/else .

3. Digitare System. nella casella Condizione per compilare un'istruzione condizione per ogni ramo if/else.

   

4. Selezionare un'azione successiva per il passaggio successivo nel flusso di lavoro.

5. Selezionare Fine. Selezionare Salva per salvare il flusso di lavoro.

Risoluzione dei problemi

Pulire le risorse

Per eliminare un flusso di lavoro non più necessario:

1. Apri il flusso di lavoro nel portale Foundry.
2. Selezionare l'elenco a discesa Versione a sinistra del pulsante Salva .
3. Selezionare Elimina per la versione da rimuovere.

Guida alla migrazione

Foundry sta passando la creazione dei flussi di lavoro a un modello basato sul codice. I flussi di lavoro visivi non scompaiono come funzionalità. I modelli di orchestrazione creati visivamente (coordinamento sequenziale e di chat di gruppo, logica di diramazione e passaggi del ciclo umano) sono tutti espliciti nel codice e nella configurazione, in modo da mantenerli durante la migrazione. Dopo il 1° dicembre 2026, la finestra di progettazione visiva e l'esecuzione del flusso di lavoro nel portale non sono supportate, ma Foundry continua a eseguire definizioni di flusso di lavoro basate su YAML quando vengono distribuite come agente ospitato.

Scegli il percorso più adatto a come vuoi creare. La maggior parte dei team deve iniziare con Microsoft Agent Framework.

Prima di eseguire la migrazione: esportare la definizione del flusso di lavoro

La definizione YAML del flusso di lavoro è l'artefatto portabile che puoi usare in uno qualsiasi dei percorsi seguenti. Salvalo prima che il Designer venga dismesso:

1. Aprire il flusso di lavoro nella finestra di progettazione del flusso di lavoro Foundry.
2. Passare alla visualizzazione YAML per visualizzare la configurazione completa.
3. Copiare o esportare il file YAML in modo da poterlo riutilizzare nel nuovo ambiente.

Agent Inspector in foundry AI Toolkit for Visual Studio Code consente di visualizzare ed eseguire definizioni del flusso di lavoro Foundry, utili durante la convalida di una migrazione. Per altre informazioni, vedere Sviluppare agenti con Agent Inspector.

Opzione 1: Microsoft Agent Framework (scelta consigliata)

Usare Microsoft Agent Framework per la maggior parte dei flussi di lavoro. L'orchestrazione che crei si mappa direttamente su Agent Framework, che supporta gli stessi modelli tramite la creazione dichiarativa in YAML o la creazione code-first. In molti casi, è possibile portare il flusso di lavoro YAML esportato in un progetto di Agent Framework ed eseguirlo con modifiche minime. Continuare quindi a eseguire l'iterazione in Visual Studio Code anziché nel portale. Poiché i flussi di lavoro non sono più un tipo di agente separato, il risultato viene eseguito distribuendolo come agente ospitato, lo stesso runtime gestito che ospita gli altri agenti basati su codice.

• Compilare ed eseguire flussi di lavoro: flussi di lavoro di Microsoft Agent Framework
• Riutilizzare il file YAML esportato con flussi di lavoro dichiarativi: panoramica dei flussi di lavoro dichiarativi
• Eseguire la distribuzione in Foundry come agente ospitato: agenti ospitati da Foundry

Opzione 2: App per la logica di Azure

Se un designer visivo è il motivo principale per cui usi i flussi di lavoro, Azure App per la logica ti offre un canvas low-code completo per l'orchestrazione e può chiamare gli agenti Foundry come passaggi. App per la logica consente di combinare passaggi deterministici, ovvero connettori, condizioni, approvazioni e centinaia di azioni predefinite, con il ragionamento probabilistico degli agenti Foundry nella stessa esecuzione. È possibile adottare agenti in modo incrementale e arricchire i processi già disponibili, invece di ricompilarli da zero.

• Creare flussi di lavoro automatizzati con la finestra di progettazione visiva: panoramica di App per la logica di Azure
• Chiamare e orchestrare gli agenti Foundry da un flusso di lavoro: eseguire flussi di lavoro automatizzati dagli agenti Foundry

Opzione 3: Connettere gli agenti direttamente con A2A

Per scenari leggeri in cui un agente deve semplicemente chiamare un altro, senza un flusso di lavoro formale e con più passaggi, esporre un agente come endpoint da agente a agente (A2A) e chiamarlo direttamente. Questo approccio mantiene l'agente chiamante nel controllo mentre delega un'attività a un agente specializzato. Per altre informazioni, vedere Abilitare un endpoint A2A in ingresso in un agente Foundry.

Contenuto correlato

• Domande frequenti sul servizio Foundry Agent
• Procedure consigliate per gli strumenti con agenti Foundry
• Lavora con i workflow dichiarativi (low-code) degli agenti in Visual Studio Code
• Lavora con i flussi di lavoro degli agenti ospitati (Pro-code) in Visual Studio Code