Creare flussi di lavoro agentici conversazionali con interazioni di chat in Azure Logic Apps

Si applica a: Azure Logic Apps (Consumo + Standard)

Quando è necessaria un'automazione basata su intelligenza artificiale che interagisce con gli esseri umani, creare flussi di lavoro dell'agente di conversazione in App per la logica di Azure. Questi flussi di lavoro usano linguaggio naturale, cicli di agenti e modelli di linguaggio di grandi dimensioni per prendere decisioni e completare attività in base a input e domande forniti dall'utente, noti come richieste. Questi flussi di lavoro funzionano meglio per l'automazione basata sull'utente, di breve durata o basata su sessione.

Il flusso di lavoro di esempio seguente usa un agente di conversazione per ottenere il meteo corrente e inviare notifiche tramite posta elettronica:

Questa guida illustra come creare un'app per la logica a consumo o Standard usando il tipo di flusso di lavoro Conversational Agents . Questo flusso di lavoro viene eseguito utilizzando prompt e strumenti forniti da esseri umani, che hai costruito per completare le attività. Per una panoramica generale dei flussi di lavoro agentici, vedere Flussi di lavoro agentici di intelligenza artificiale in App per la logica di Azure.

Prerequisiti

• Account e sottoscrizione di Azure. Ottenere un account Azure gratuito.

In base al fatto che si voglia creare un'app per la logica a consumo o Standard, si applicano i prerequisiti seguenti:

• Per seguire gli esempi, è necessario un account di posta elettronica per inviare un messaggio di posta elettronica.

  Gli esempi in questa guida usano un account Outlook.com. Per gli scenari personalizzati, è possibile usare qualsiasi servizio di posta elettronica o app di messaggistica supportata in App per la logica di Azure, ad esempio Office 365 Outlook, Microsoft Teams, Slack e così via. La configurazione per altri servizi di posta elettronica o app è simile agli esempi, ma presenta differenze minime.

Limitazioni e problemi noti

Nella tabella seguente vengono descritte le limitazioni correnti e i problemi noti in questa versione.

Modelli di servizio OpenAI di Azure supportati per i flussi di lavoro agenti

L'elenco seguente specifica i modelli di intelligenza artificiale che è possibile usare con i flussi di lavoro agenti:

Billing

• Consumo: la fatturazione usa il modello con pagamento in base al consumo. I prezzi del ciclo dell'agente si basano sul numero di token usati da ogni azione dell'agente e vengono visualizzati come unità aziendali nella fattura. Per informazioni specifiche sui prezzi, vedere Prezzi di App per la logica di Azure.

• Standard: anche se i flussi di lavoro agenti non comportano costi aggiuntivi, l'utilizzo del modello di intelligenza artificiale comporta addebiti. Per altre informazioni, vedere calcolatore prezzi di Azure.

Creare un flusso di lavoro agentico di conversazione

La sezione seguente illustra come iniziare a creare il flusso di lavoro di un assistente conversazionale.

Configurare o visualizzare il modello di intelligenza artificiale

Per configurare o visualizzare il modello di intelligenza artificiale per l'agente, seguire i passaggi in base al tipo di app per la logica:

Rinominare l'azione dell'agente

Aggiornare il nome dell'azione dell'agente per identificare chiaramente lo scopo dell'agente seguendo questa procedura:

1. Nell'area del designer selezionare la barra del titolo dell'azione di un agente per aprire il riquadro delle informazioni sull'azione dell'agente.

2. Nel riquadro informazioni selezionare il nome dell'azione dell'agente e immettere il nuovo nome, ad esempio Weather agent.

   

3. Andare alla sezione successiva per fornire istruzioni per il ciclo degli agenti.

Configurare le istruzioni del loop agente

Il ciclo dell'agente richiede istruzioni che descrivono i ruoli che il ciclo dell'agente può eseguire e le attività che il ciclo dell'agente può eseguire. Per consentire al ciclo dell'agente di apprendere e comprendere queste responsabilità, è anche possibile includere le informazioni seguenti:

• Struttura del flusso di lavoro
• Azioni disponibili
• Eventuali restrizioni o limitazioni
• Interazioni per scenari specifici o casi speciali

Per ottenere risultati ottimali, fornire istruzioni prescrittive e prepararsi a perfezionare in modo iterativo le istruzioni.

1. Nella casella Istruzioni per l'agente immettere le istruzioni necessarie per comprendere il ruolo e le attività del ciclo dell'agente.

   Per questo esempio, l'esempio dell'agente meteo usa le istruzioni di esempio seguenti in cui in seguito vengono poste domande e specificare il proprio indirizzo di posta elettronica per il test:

   You're an AI agent that answers questions about the weather for a specified location. You can also send a weather report in email if you're provided email address. If no address is provided, ask for an email address.
   
   Format the weather report with bullet lists where appropriate. Make your response concise and useful, but use a conversational and friendly tone. You can include suggestions like "Carry an umbrella" or "Dress in layers".
   

   Ecco un esempio:

   

2. È ora possibile salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

Verificare la presenza di errori

Per assicurarsi che il flusso di lavoro non presenti errori in questa fase, seguire questa procedura, in base all'app per la logica e all'ambiente di sviluppo.

Creare uno strumento 'Ottieni meteo'

Affinché un agente esegua azioni predefinite disponibili in App per la logica di Azure, è necessario creare uno o più strumenti per il ciclo dell'agente da usare. Uno strumento deve contenere almeno un'azione e solo azioni. Il ciclo dell'agente chiama lo strumento usando argomenti specifici.

In questo esempio, il ciclo dell'agente richiede uno strumento che fornisce la previsione meteo. È possibile compilare questo strumento seguendo questa procedura:

1. Nella finestra di progettazione, all'interno dell'azione agente e in Aggiungi strumento selezionare il segno più (+) per aprire il riquadro in cui è possibile esplorare le azioni disponibili.

2. Nel riquadro Aggiungi un'azione seguite i passaggi generali per il Logic App per aggiungere l'azione più adatta al vostro scenario.

   In questo esempio viene utilizzata l'azione MSN Weather denominata Get current weather.

   Dopo aver selezionato l'azione, sia il contenitore relativo allo strumento sia l'azione selezionata sono visualizzati nel ciclo degli agenti nella finestra di progettazione. Entrambi i riquadri informazioni vengono aperti contemporaneamente.

   

3. Nel riquadro delle informazioni sullo strumento rinominare lo strumento per descriverne lo scopo. Per questo esempio, usare Get weather.

4. Nella scheda Dettagli immettere la descrizione dello strumento per Descrizione. Per questo esempio, usare Get the weather for the specified location.

   

   In Descrizione la sezione Parametri agente si applica solo per casi d'uso specifici. Per altre informazioni, vedere Creare parametri dell'agente.

5. Passare alla sezione successiva per altre informazioni sui parametri dell'agente, sui relativi casi d'uso e su come crearli, in base a questi casi d'uso.

Creare i parametri dell'agente per l'azione 'Ottieni il meteo attuale'

Le azioni in genere hanno parametri che richiedono di specificare i valori da usare. Le azioni negli strumenti sono quasi uguali, ad eccezione di una differenza. È possibile creare parametri dell'agente usati dal ciclo dell'agente per specificare i valori dei parametri per le azioni negli strumenti. È possibile specificare output generati dal modello, valori da origini non modello o una combinazione. Per altre informazioni, vedere Parametri di Agent.

Nella tabella seguente vengono descritti i casi d'uso per la creazione di parametri dell'agente e la posizione in cui crearli, in base al caso d'uso:

Usare solo output generati dal modello

Per un parametro di azione che usa solo output generati dal modello, creare un parametro dell'agente seguendo questa procedura:

1. Nello strumento selezionare l'azione per aprire il riquadro informazioni.

   Per questo esempio, l'azione è Get current weather (Ottieni meteo corrente).

2. Nella scheda Parametri selezionare all'interno della casella dei parametri per visualizzare le opzioni dei parametri.

3. Sul bordo destro della casella Posizione selezionare il pulsante stelle.

   Questo pulsante ha la descrizione comando seguente: Selezionare questa opzione per generare il parametro dell'agente.

   

   La finestra Crea parametro agente mostra i campi Nome, Tipo e Descrizione , prepopolati dal parametro dell'azione di origine.

   Nella tabella seguente vengono descritti i campi che definiscono il parametro dell'agente:

   Parametro	Value	Description
   Nome	< agent-parameter-name>	Nome del parametro dell'agente.
   Tipo	< tipo-di-dati-del-parametro-agente>	Tipo di dati del parametro dell'agente.
   Descrizione	< agent-parameter-description>	Descrizione del parametro dell'agente che identifica facilmente lo scopo del parametro.

   Annotazioni

   Microsoft consiglia di seguire la definizione di Swagger dell'azione. Ad esempio, per l'azione Get current weather, che proviene dal connettore MSN Weather "shared" ospitato e gestito da Global, Multi-Tenant Azure, vedere l'articolo di riferimento tecnico sul connettore MSN Weather.

4. Al termine, selezionare Crea.

   L'esempio seguente mostra l'azione Get current weather con il parametro Location Agent:

   

5. Salvare il flusso di lavoro.

Usare valori da origini non modello

Per un valore del parametro di azione che usa solo valori non di modello, scegliere l'opzione più adatta al caso d'uso:

Usare gli output delle operazioni precedenti nel flusso di lavoro

Per esplorare e selezionare da questi output, seguire questa procedura:

1. Selezionare all'interno della casella dei parametri e quindi selezionare l'icona a forma di fulmine per aprire l'elenco di contenuto dinamico.

2. Nell'elenco, nella sezione "trigger" o "azione", selezionare l'output desiderato.

3. Salvare il flusso di lavoro.

Usare i risultati delle espressioni

Per creare un'espressione, seguire questa procedura:

1. Selezionare all'interno della casella del parametro e quindi selezionare l'icona della funzione per aprire l'editor di espressioni.

2. Selezionare le funzioni disponibili per creare l'espressione.

3. Salvare il flusso di lavoro.

Per altre informazioni, vedere Guida di riferimento alle funzioni delle espressioni del flusso di lavoro in App per la logica di Azure.

Usare gli output del modello e i valori non modello

Alcuni scenari potrebbero dover specificare un valore del parametro di azione che usa entrambi gli output generati dal modello con valori non di modello. Ad esempio, è possibile creare un corpo del messaggio di posta elettronica che usa testo statico, output nonmodelli delle operazioni precedenti nel flusso di lavoro e output generati dal modello.

Per questi scenari, creare il parametro dell'agente nello strumento seguendo questa procedura:

1. Nella finestra di progettazione selezionare lo strumento in cui si vuole creare il parametro dell'agente.

2. Nella scheda Dettagli , in Parametri agente, selezionare Crea parametro.

3. Espandi Nuovo parametro agente e specifica le informazioni seguenti, assicurandoti di corrispondere ai dettagli del parametro dell'azione.

   Per questo esempio, l'azione di esempio è Ottieni il meteo attuale.

   Annotazioni

   Microsoft consiglia di seguire la definizione di Swagger dell'azione. Ad esempio, per trovare queste informazioni per l'azione Get current weather (Ottieni meteo corrente), vedere l'articolo di riferimento tecnico sul connettore MSN Weather. L'azione di esempio viene fornita dal connettore gestito MSN Weather , ospitato ed eseguito in un cluster condiviso in Azure multi-tenant.

   Parametro	Value	Description
   Nome	< agent-parameter-name>	Nome del parametro dell'agente.
   Tipo	< tipo-di-dati-del-parametro-agente>	Tipo di dati del parametro dell'agente.
   Descrizione	< agent-parameter-description>	Descrizione del parametro dell'agente che identifica facilmente lo scopo del parametro. È possibile scegliere tra le opzioni seguenti o combinarle per fornire una descrizione: - Testo letterale normale con dettagli come lo scopo del parametro, valori consentiti, restrizioni o limiti. Gli output prodotti dalle operazioni precedenti nel flusso di lavoro. Per esplorare e scegliere questi output, selezionare all'interno della casella Descrizione e quindi selezionare l'icona a forma di fulmine per aprire l'elenco di contenuto dinamico. Nell'elenco selezionare l'output desiderato. - Risultati delle espressioni. Per creare un'espressione, selezionare all'interno della casella Descrizione e quindi selezionare l'icona della funzione per aprire l'editor di espressioni. Selezionare le funzioni disponibili per creare l'espressione.

   Al termine, in Parametri agente viene visualizzato il nuovo parametro dell'agente.

4. Nello strumento visualizzato nella finestra di progettazione, selezionare l'azione per aprire il riquadro informazioni sull'azione.

5. Nella scheda Parametri selezionare all'interno della casella dei parametri per visualizzare le opzioni dei parametri e quindi selezionare l'icona del robot.

6. Nell'elenco Parametri agente selezionare il parametro dell'agente definito in precedenza.

   Lo strumento Get current weather fatto sembra come nell'esempio seguente:

   

7. Salvare il flusso di lavoro.

Creare uno strumento "Invia messaggio di posta elettronica"

Per molti scenari, un agente richiede in genere più di uno strumento. In questo esempio, il ciclo degli agenti ha bisogno di uno strumento che invii il report meteo in un messaggio e-mail.

Per compilare questo strumento, seguire questa procedura:

1. Nella finestra di progettazione, nell'agente, accanto allo strumento esistente, selezionare il segno più (+) per aggiungere un'azione.

2. Nel riquadro Aggiungi un'azione seguire questa procedura generale per selezionare un'altra azione per il nuovo strumento.

   Negli esempi viene usata l'azione Outlook.com denominata Invia un messaggio di posta elettronica (V2).

   Come in precedenza, dopo aver selezionato l'azione, sia il nuovo strumento sia l'azione vengono visualizzati contemporaneamente nel ciclo degli agenti nella finestra di progettazione. Entrambi i riquadri informazioni vengono aperti contemporaneamente.

   

3. Nel riquadro delle informazioni sullo strumento rinominare lo strumento per descriverne lo scopo. Per questo esempio, usare Send email.

4. Nella scheda Dettagli immettere la descrizione dello strumento per Descrizione. Per questo esempio, usare Send current weather by email.

   

Creare i parametri dell'agente per l'azione "Invia un messaggio di posta elettronica (V2)"

Ad eccezione dei diversi parametri dell'agente da configurare per l'azione Invia un messaggio di posta elettronica (V2), la procedura descritta in questa sezione è quasi identica a quella dei parametri dell'agente per l'azione "Ottieni meteo corrente".

• Seguire i passaggi generali precedenti per creare i parametri dell'agente per i valori dei parametri nell'azione Invia un messaggio di posta elettronica (V2).

  L'azione richiede tre parametri dell'agente denominati A, Oggetto e Corpo. Per la definizione di Swagger dell'azione, vedere Inviare un messaggio di posta elettronica (V2).

  Al termine, l'azione di esempio usa i parametri dell'agente definiti in precedenza, come illustrato nell'immagine seguente:

  

  Lo strumento Invia messaggio di posta elettronica completato è simile all'esempio seguente:

  

Procedure consigliate per cicli degli agenti e strumenti

Le sezioni seguenti forniscono raccomandazioni, procedure consigliate e altre linee guida che consentono di creare cicli e strumenti agente migliori.

Cicli dell'agente

Le indicazioni seguenti forniscono procedure consigliate per i cicli agente.

Cicli degli agenti e strumenti prototipo con azioni "Componi"

Anziché usare azioni effettive e connessioni attive per creare prototipi di cicli degli agenti e strumenti, usare le azioni Componi per simulare le azioni effettive. Questo approccio offre i vantaggi seguenti:

• Le azioni di composizione non producono effetti collaterali, che rendono queste azioni utili per ideazione, progettazione e test.

• È possibile elaborare e perfezionare le istruzioni del ciclo dell'agente, le richieste, i nomi degli strumenti e le descrizioni, oltre ai parametri e alle descrizioni degli agenti, senza dover configurare e usare connessioni dinamiche.

• Quando si conferma che il ciclo degli agenti e gli strumenti funzionano solo con le azioni Componi, è possibile sostituire le azioni effettive.

• Quando si passa alle azioni effettive, è necessario reindirizzare o ricreare i parametri dell'agente per lavorare con le azioni effettive, che potrebbero richiedere del tempo.

Gestire la lunghezza del contesto della cronologia delle chat

Il ciclo dell'agente gestisce la cronologia o il contesto della chat, incluse le chiamate allo strumento, in base al limite corrente per il numero di token o messaggi da mantenere e passare al modello per l'interazione successiva. Nel corso del tempo, la cronologia del ciclo dell'agente aumenta e alla fine supera il limite di lunghezza del contesto del modello o il numero massimo di token di input. I modelli differiscono per la loro lunghezza del contesto.

Ad esempio, gpt-4o supporta 128.000 token di input in cui ogni token ha 3-4 caratteri. Quando la cronologia del ciclo degli agenti si avvicina alla lunghezza del contesto del modello, prendere in considerazione l'eliminazione di messaggi non aggiornati o irrilevanti per rimanere entro i limiti.

Ecco alcuni approcci per ridurre la cronologia del ciclo dell'agente:

• Riduci le dimensioni dei risultati degli strumenti utilizzando l'azione Componi. Per altre informazioni, vedere Strumenti - Procedure consigliate.

• Creare attentamente le istruzioni e i prompt del ciclo degli agenti per controllare il comportamento del modello.

• Funzionalità sperimentali: è possibile provare la riduzione della chat in modo da ridurre il numero massimo di token o messaggi da mantenere nella cronologia delle chat e passare al modello.

  Il ciclo dell'agente ha quasi gli stessi parametri avanzati del connettore integrato Azure OpenAI del provider di servizi, ad eccezione del parametro avanzato Tipo di Riduzione della Cronologia dell'Agente, che esiste solo nell'azione agente. Questo parametro controlla la cronologia gestita dal ciclo dell'agente, in base al numero massimo di token o messaggi.

  Questa funzionalità è in fase di sviluppo attivo e potrebbe non funzionare per tutti gli scenari. È possibile modificare l'opzione Tipo di riduzione cronologia dell'agente per ridurre il limite di token o messaggi. Specificare quindi il limite numerico desiderato.

  Per provare la funzionalità, seguire questa procedura:

  1. Nella finestra di progettazione selezionare la barra del titolo dell'azione dell'agente per aprire il riquadro delle informazioni.

  2. Nella scheda Parametri individuare la sezione Parametri avanzati .

  3. Controllare se il parametro denominato Agent History Reduction Type esiste. In caso contrario, aprire l'elenco Parametri avanzati e selezionare tale parametro.

  4. Nell'elenco Tipo riduzione cronologia agente selezionare una delle opzioni seguenti:

     Opzione	Description
     Riduzione del numero di token	Mostra il parametro denominato Maximum Token Count. Specifica il numero massimo di token nella cronologia dei cicli dell'agente da mantenere e passare al modello per l'interazione successiva. Il valore predefinito è diverso in base al modello attualmente usato nel servizio OpenAI di Azure. Il limite predefinito è 128.000.
     Riduzione del numero di messaggi	Mostra il parametro denominato Message Count Limit. Specifica il numero massimo di messaggi nella cronologia del ciclo dell'agente da mantenere e passare al modello per l'interazione successiva. Non esiste alcun limite predefinito.

Tools

Le indicazioni seguenti forniscono procedure consigliate per gli strumenti.

• Il nome è il valore più importante per uno strumento. Assicurarsi che il nome sia conciso e descrittivo.

• La descrizione dello strumento fornisce un contesto utile e vantaggioso per lo strumento.

• Sia il nome dello strumento che la descrizione hanno limiti di caratteri.

  Alcuni limiti vengono applicati dal modello nel servizio Azure OpenAI in fase di esecuzione, anziché quando si salvano le modifiche nel ciclo dell'agente nel flusso di lavoro.

• Troppi strumenti nello stesso ciclo di agenti possono avere un effetto negativo sulla qualità del ciclo dell'agente.

  Una buona linea guida generale consiglia che un ciclo di agenti non includa più di 10 strumenti. Tuttavia, queste linee guida variano in base al modello usato dal servizio OpenAI di Azure.

• Negli strumenti non è necessario che tutte le azioni abbiano tutti gli input provenienti dal modello.

  È possibile controllare con precisione quali input di azione provengono da origini non modello e quali input provengono dal modello. Si supponga, ad esempio, che uno strumento abbia un'azione che invia un messaggio di posta elettronica. È possibile fornire un corpo di posta elettronica semplice e principalmente statico, ma usare output generati dal modello per parte del corpo del messaggio di posta elettronica.

• Personalizzare o trasformare i risultati degli strumenti prima di passarli al modello.

  È possibile modificare i risultati da uno strumento prima di passare al modello usando l'azione Componi. Questo approccio offre i vantaggi seguenti:

  • Migliorare la qualità della risposta riducendo il contesto irrilevante che passa al modello. Si inviano solo i campi necessari da una risposta ampia.

  • Ridurre gli addebiti per la fatturazione per i token che passano al modello ed evitare di superare il limite del modello per la lunghezza del contesto, il numero massimo di token che passano al modello. Si inviano solo i campi necessari.

  • Combinare i risultati di più azioni nello strumento.

  • È possibile simulare i risultati dello strumento per simulare i risultati previsti dalle azioni effettive. Le azioni fittizie lasciano invariati i dati nell'origine e non comportano addebiti per l'utilizzo delle risorse all'esterno di App per la logica di Azure.

Parametri dell'agente

Le indicazioni seguenti forniscono le procedure consigliate per i parametri dell'agente.

• Il nome è il valore più importante per un parametro dell'agente. Assicurarsi che il nome sia conciso e descrittivo.

• La descrizione del parametro dell'agente fornisce un contesto utile e vantaggioso per lo strumento.

Attivare o eseguire il flusso di lavoro

È possibile attivare o eseguire flussi di lavoro di agenti conversazionali nei modi seguenti, in base all'ambiente di distribuzione:

La tabella seguente descrive come gli utenti o i client di chat usano l'URL del client di chat per eseguire il flusso di lavoro nell'ambiente di produzione:

Per incorporare l'URL del client di chat in un elemento HTML iFrame, usare il formato seguente:

Autenticazione e autorizzazione

Per le attività non di produzione, ad esempio progettazione, sviluppo e test rapidi, il portale di Azure fornisce, gestisce e usa una chiave per sviluppatori per eseguire il flusso di lavoro ed eseguire azioni per conto dell'utente. L'elenco seguente consiglia alcune procedure consigliate per la gestione di questa chiave per sviluppatori:

• Considerare la chiave dello sviluppatore strettamente come una comodità in fase di progettazione per l'autenticazione e l'autorizzazione.

• Prima di esporre il vostro flusso di lavoro conversazionale ad altri agenti, automazioni o popolazioni di utenti più ampie, migrate a un SAS firmato con restrizioni di rete o utilizzate i seguenti metodi di autenticazione e autorizzazione per le chat esterne, in base al tipo di flusso di lavoro conversazionale:

  Flusso di lavoro	Authentication
  Consumption	OAuth 2.0 con MICROSOFT Entra ID
  Normale	Identità gestita, autenticazione semplice (autenticazione del servizio app)

  Se qualcuno o qualsiasi elemento esterno alla sessione del portale di Azure deve chiamare o interagire con il flusso di lavoro, non usare la chiave per sviluppatori.

Quando si è pronti per rilasciare il flusso di lavoro agentico nell'ambiente di produzione, seguire la procedura di migrazione per preparare l'autenticazione e l'autorizzazione nell'ambiente di produzione. Per altre informazioni, vedere Autenticazione e autorizzazione.

Eseguire la migrazione all'autenticazione di produzione

1. Nella risorsa della Logic App configurare la seguente autenticazione in base al tipo di workflow:

   Flusso di lavoro	Authentication
   Consumption	OAuth 2.0 con Microsoft Entra ID con la creazione di un criterio di autorizzazione dell'agente nella risorsa dell'app per la logica. Per creare questo criterio, seguire questa procedura: 1. Seguire i passaggi generali per creare i criteri, ma usare i passaggi successivi per il resto. 2. Selezionare Azure Active Directory (AAD). 3. Selezionare Regola di autorizzazione dell'agente (per agenti conversazionali). 4. Sotto ID oggetto, immettere l'ID oggetto per ogni utente, app o app aziendale che può accedere al loop dell'agente. 5. Al termine, sulla barra degli strumenti selezionare Salva. Per altre informazioni, vedere: - Individuare gli ID importanti per un utente - Oggetti applicazione ed entità servizio in Microsoft Entra ID
   Normale	Identità gestita, autenticazione semplice (autenticazione del servizio app)

2. Applicare i modelli di accesso necessari per l'autenticazione.

3. Facoltativamente, è possibile bloccare gli URL degli endpoint trigger disabilitando o rigenerando qualsiasi URL SAS inutilizzato.

4. Per includere l'interfaccia client di chat esterna in un sito Web o in qualsiasi altra posizione per supportare le interazioni umane, ottenere l'URL del client di chat e incorporare l'URL in un elemento HTML iFrame seguendo questa procedura:

   1. Sulla barra degli strumenti della finestra di progettazione o sulla barra laterale del flusso di lavoro selezionare Chat.

   2. Nella sezione Informazioni di base copiare o selezionare il collegamento URL client chat , che viene aperto nella nuova scheda del browser.

   3. Incorporare l'URL del client di chat in un elemento HTML iFrame, che usa il formato seguente:

      Flusso di lavoro	Elemento HTML iFrame
      Consumption	<iframe src="https://agents.<region>.logic.azure.com/scaleunits/<scale-unit-ID>/flows/<workflow-ID>/agentChat/IFrame" title="<chat-client-name>"></iframe>
      Normale	<iframe src="https://<logic-app-name>.azurewebsites.net/api/agentsChat/<workflow-name>/IFrame" title="<chat-client-name>"></iframe>

Risolvere i problemi di migrazione dell'autenticazione

La tabella seguente descrive i problemi comuni che possono verificarsi quando si tenta di eseguire la migrazione da una chiave di sviluppo a Easy Auth, le possibili cause e le azioni che è possibile eseguire:

Risoluzione dei problemi

In questa sezione vengono descritte indicazioni utili per risolvere gli errori o i problemi che possono verificarsi durante la compilazione o l'esecuzione di flussi di lavoro agenti.

Esaminare i dati di esecuzione dello strumento

La cronologia di esecuzione del flusso di lavoro fornisce informazioni utili che consentono di apprendere cosa è accaduto durante un'esecuzione specifica. Per un flusso di lavoro agenziale, è possibile trovare input e output di esecuzione degli strumenti per una specifica iterazione del ciclo dell'agente.

1. Nel menu del flusso di lavoro, in Strumenti, selezionare Cronologia di esecuzione per aprire la pagina Cronologia di esecuzione .

2. Nella colonna Identificatore della scheda Cronologia di esecuzione selezionare l'esecuzione del flusso di lavoro desiderata.

   Viene visualizzata la visualizzazione di monitoraggio per visualizzare lo stato di ogni passaggio.

3. Selezionare l'azione dell'agente da esaminare. A destra, si apre il riquadro Log agente.

   Questo riquadro mostra il log dell'agente, incluse le esecuzioni degli strumenti durante l'interazione.

4. Per ottenere i dati di esecuzione degli strumenti in un punto specifico, individuare tale punto nel log dell'agente e selezionare il riferimento all'esecuzione dello strumento, ad esempio:

   

   Questa azione consente di passare allo strumento di confronto nella vista di monitoraggio. L'azione dell'agente mostra il numero di iterazioni corrente.

5. Nella visualizzazione monitoraggio selezionare l'azione dell'agente o l'azione con gli input, gli output e le proprietà da esaminare.

   L'esempio seguente mostra un'azione selezionata per l'esecuzione dello strumento selezionata in precedenza:

   

   Se si seleziona l'agente, è possibile esaminare le informazioni seguenti che passano al modello e vengono restituite dal modello, ad esempio:

   • Messaggi di input passati al modello.
   • Messaggi di output restituiti dal modello.
   • Strumenti che il modello ha chiesto al ciclo degli agenti di chiamare.
   • Risultati degli strumenti reimmessi nel modello.
   • Numero di token usati da ogni richiesta.

6. Per esaminare un'iterazione del ciclo degli agenti diversa, nell'agente selezionare la freccia sinistra o destra.

Log in Application Insights

Se si configura Application Insights o i dati di telemetria avanzati per il flusso di lavoro, è possibile esaminare i log per gli eventi del ciclo dell'agente, come qualsiasi altra azione. Per altre informazioni, vedere Abilitare e visualizzare dati di telemetria avanzati in Application Insights per flussi di lavoro Standard in App per la logica di Azure.

Superata la lunghezza massima del contesto del modello

Se la cronologia dei log dell'agente supera la lunghezza del contesto del modello o il numero massimo di token di input, viene visualizzato un errore simile all'esempio seguente:

La lunghezza massima del contesto di questo modello è di 4097 token. Tuttavia, sono stati richiesti 4927 token (3927 nei messaggi, 1000 al completamento). Si prega di ridurre la lunghezza dei messaggi o del completamento.

Provare a ridurre il limite al numero di token o messaggi che il ciclo degli agenti mantiene nel log e passare al modello per l'interazione successiva. Per questo esempio, è possibile selezionare Riduzione del numero di token e impostare Numero massimo token su un numero inferiore alla lunghezza massima del contesto dichiarata dall'errore, ovvero 4097.

Per altre informazioni, vedere Gestire la lunghezza del contesto della cronologia delle chat.

Pulire le risorse di esempio

Se non sono necessarie le risorse create per gli esempi, assicurarsi di eliminare le risorse in modo da non continuare a ricevere addebiti. È possibile seguire questa procedura per eliminare il gruppo di risorse che contiene queste risorse oppure eliminare ogni risorsa singolarmente.

1. Nella casella di ricerca di Azure immettere gruppi di risorse e selezionare Gruppi di risorse.

2. Trovare e selezionare i gruppi di risorse che contengono le risorse per questo esempio.

3. Nella pagina Panoramica selezionare Elimina gruppo di risorse.

4. Quando viene visualizzato il riquadro di conferma, immettere il nome del gruppo di risorse e selezionare Elimina.

Contenuti correlati

• Flussi di lavoro con agenti di intelligenza artificiale in Azure Logic Apps
• Lab - Creare il primo flusso di lavoro agentico di conversazione in App per la logica di Azure
• Limiti e configurazione per App per la logica di Azure
• Quote e limiti del servizio OpenAI di Azure