Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Agenti dell'interfaccia utente
<a name="ui-agents"></a>

L'agente UI è un agente nativo che comprende le istruzioni in linguaggio naturale per eseguire azioni complesse del browser. Può navigare autonomamente nei siti Web, fare clic, digitare, leggere dati e produrre output strutturati ottimizzati per le fasi di automazione a valle. I casi d'uso esemplificativi includono il riepilogo dei prodotti su una pagina Web o il recupero di dati navigando nei siti Web.

## Properties
<a name="ui-agent-properties"></a>

Titolo  
Nome dell'agente step/UI 

Istruzioni  
In questo campo si scrive il prompt per l'agente in linguaggio naturale. Procedure consigliate durante la scrittura del prompt:  
+ Sii chiaro ed esplicito su ciò che desideri.
+ Struttura il prompt. Inizia citando prima l' "Attività» o il «Ruolo» e poi le «Istruzioni» per completare l'attività con passaggi numerati
+ Aggiungi dei vincoli (ad esempio, consulta solo la sezione prodotti) e specifica quando farlo stop/end (ad esempio, interrompi quando trovi le informazioni pertinenti)
+ Fornisci esempi positivi e negativi (non farlo)
+ Specificate chiaramente i requisiti di lunghezza (ad esempio, meno di 100 parole) o il formato di output (ad esempio, data in MM/DD/YY formato)
Raccogli il testo tra virgolette triple («"») per scrivere istruzioni su più righe. Esempio:  

```
"""Task: Locate the company's latest annual report.
* Visit the provided URL.
* Look for the annual report. The report may be titled 'Annual Report', 'Financial Report', 'Year in Review', or similar variations..."""
```

Output strutturato (opzionale)  
Agent Response: nome della variabile a cui assegnare l'output di questa operazione

## Come configurare i campi di output strutturati
<a name="ui-agent-structured-output"></a>

**Aggiungere campi**
+ Fai clic su Aggiungi campo per creare un nuovo campo di output
+ Inserisci il nome di output: questo diventa il nome della proprietà JSON
+ Seleziona il tipo dal menu a discesa
+ Seleziona Obbligatorio se il campo deve essere sempre presente
+ Aggiungi una descrizione per guidare l'agente AI

**Tipi di campo**
+ *Stringa*: valori di testo (nomi, descrizioni, riassunti)
+ *Numero*: valori numerici (conteggi, punteggi, percentuali)
+ *Booleano* - True/false valori (contrassegni di stato, domande) yes/no 
+ *Oggetto*: struttura annidata (raggruppamenti di dati complessi)
+ *Array*: elenco di elementi (tag, categorie, valori multipli)
+ *File* - Riferimenti ai file (allegati dei documenti, immagini)
+ *Tabella dati* - Dati tabulari (set di dati strutturati, report)

**Lavorare con tipi complessi**

Gli oggetti e gli array possono contenere campi annidati:
+ Fai clic sulla freccia di espansione (▶) accanto ai campi Oggetto o Matrice
+ Usa Aggiungi campo all'interno della struttura annidata
+ Mantieni la nidificazione a un massimo di 2-3 livelli per prestazioni ottimali

**Configurazione di esempio**

Ecco una semplice configurazione per riepilogare il feedback dei clienti:

```
{
  "orderId": "12345",
  "numberOfOrders": 3,
  "hasShipped": true,
  "orderDetails": {
    "quantity": 2,
    "productName": "ABC",
  },
  "tags": ["electronics", "urgent"]
}
```

Questa struttura verrebbe configurata come:
+ orderID (String, obbligatorio)
+ numero OfOrders (numero, obbligatorio)
+ hasShipped (booleano, obbligatorio)
+ OrderDetails (oggetto, obbligatorio)
  + quantità (numero, obbligatorio)
  + ProductName (stringa, obbligatorio)
+ tag (matrice di stringhe, opzionale)

**Best practice**
+ Usa nomi di campo descrittivi: aiuta l'IA a capire quali dati estrarre
+ Aggiungi descrizioni chiare: fornisci un contesto per campi complessi
+ Contrassegna i campi critici come richiesti: assicurati che i dati essenziali siano sempre presenti
+ Limita la profondità di nidificazione: mantieni le strutture semplici per prestazioni migliori
+ Verifica la tua configurazione: verifica che l'output corrisponda alle tue aspettative eseguendo la fase dell'agente e verificando la risposta.

**Note importanti**
+ Conoscenze JSON: non conosci JSON? Scopri le nozioni di base su json.org
+ Nessuna convalida: attualmente, il sistema non convalida la struttura di output: assicurati che l'automazione gestisca i dati mancanti o non corretti