> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Output strutturato

> Scopri come usare in modo efficace l'output strutturato e interagire con le sessioni di Devin tramite API

> [!NOTE]
>
> L'output strutturato è come il blocco note di Devin: aggiorna i suoi appunti mentre lavora e puoi consultarli in qualsiasi momento. Al momento non puoi forzare Devin ad aggiornare i suoi appunti, ma puoi chiedere di vedere cosa ha scritto finora.

> **Aggiornamenti sui progressi**
>
> Ricevi aggiornamenti sui progressi di Devin durante le attività di lunga durata

> **Integrazione con le applicazioni**
>
> Instrada l'analisi e gli output di Devin nelle tue applicazioni usando un formato JSON coerente.

## Richiedere output strutturato

Per usare l'output strutturato, includi lo schema JSON desiderato nel prompt quando [crei una sessione](https://docs.devinenterprise.com/it/api-reference/v1/sessions/create-a-new-devin-session.md).
Assicurati di indicare a Devin di aggiornare l'output strutturato ogni volta che accade qualcosa di rilevante.

**Revisione PR**

```json theme={null}
{
  "prompt": "Esamina questa PR e fornisci gli aggiornamenti in questo formato. Aggiorna immediatamente l'output strutturato ogni volta che trovi nuovi problemi, hai suggerimenti o cambi il tuo stato di approvazione:\n{
    "issues": [
      {
        "file": "src/App.tsx",
        "line": 42,
        "type": "bug",
        "description": "Memory leak nel cleanup di useEffect"
      }
    ],
    "suggestions": [
      "Aggiungere la gestione degli errori per le chiamate API",
      "Suddividere il componente in parti più piccole"
    ],
    "approved": false
  }"
}
```

Formato semplice per revisioni di PR e analisi del codice.

**Aggiornamenti di avanzamento**

```json theme={null}
{
  "prompt": "Man mano che lavori, fornisci aggiornamenti in questo formato. Aggiorna immediatamente l'output strutturato ogni volta che inizi una nuova attività, completi un'attività o pianifichi la tua prossima attività:\n{
    "status": "in_progress",
    "current_task": "Adding authentication to login page",
    "completed_tasks": [
      "Set up project structure",
      "Added routing"
    ],
    "next_task": "Implement form validation"
  }"
}
```

Tieni traccia di ciò su cui Devin sta lavorando attualmente e di cosa verrà dopo.

**Risultati dei test**

```json theme={null}
{
  "prompt": "Durante l'esecuzione dei test, riporta i risultati in questo formato. Aggiorna immediatamente l'output strutturato dopo ogni esecuzione dei test e ogni volta che la copertura cambia:\n{
    "tests_passed": 25,
    "tests_failed": 2,
    "failing_tests": [
      {
        "name": "login_validation",
        "error": "Expected error message to be shown"
      }
    ],
    "coverage": 85
  }"
}
```

Panoramica semplice dei risultati dell'esecuzione dei test.

**Implementazione di funzionalità**

```json theme={null}
{
  "prompt": "Crea una pagina delle impostazioni utente e traccia l'avanzamento in questo formato. Aggiorna immediatamente l'output strutturato ogni volta che completi un requisito, crei nuovi file, identifichi elementi da revisionare o modifichi lo stato dei test:\n{
    "requirements_met": {
      "can_change_password": true,
      "can_update_email": false,
      "dark_mode_toggle": true
    },
    "files_created": [
      "UserSettings.tsx",
      "useUpdateProfile.ts"
    ],
    "needs_review": [
      "Il flusso di aggiornamento dell'email richiede una revisione di sicurezza"
    ],
    "ready_for_testing": false
  }"
}
```

Tieni traccia dell'implementazione della funzionalità rispetto a requisiti specifici.

## Recuperare l'output strutturato

Usa [questo endpoint](https://docs.devinenterprise.com/it/api-reference/v1/sessions/retrieve-details-about-an-existing-session.md) per recuperare l'output strutturato da una sessione.
L'output strutturato viene restituito nel campo `structured_output`.

> [!TIP]
>
> Quando utilizzi l'applicazione web Devin, puoi visualizzare rapidamente l'output strutturato in qualsiasi momento premendo `⌘ + I` (Command+I).

## Best practice

* Includi la definizione completa dello schema nel prompt iniziale
* Definisci la frequenza di aggiornamento prevista (ad es. "Aggiorna l'output strutturato ogni volta che aggiungi un nuovo componente al sito web")
* Documenta in modo chiaro i tipi di valori e i relativi formati
* Usa nomi di campo chiari e descrittivi in modo che Devin sappia cosa scrivere
* Includi valori di esempio nel tuo schema
* Usa intervalli di 10-30 secondi per il polling per evitare di sovraccaricare la Devin API
* Interrompi il polling quando la sessione termina o si verifica un errore

> [!NOTE]
>
> Ricorda che Devin aggiorna l'output strutturato con una propria cadenza: non puoi forzare un aggiornamento, ma puoi sempre chiedere di vedere le note più recenti.

Per domande sull'uso dell'output strutturato o per segnalare problemi, invia un'email a [support@cognition.ai](mailto:support@cognition.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.