Vai al contenuto principale
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. Assicurati di indicare a Devin di aggiornare l’output strutturato ogni volta che accade qualcosa di rilevante.
  • Revisione PR
  • Aggiornamenti di avanzamento
  • Risultati dei test
  • Implementazione di funzionalità
{
  "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.

​
Recuperare l’output strutturato

Usa questo endpoint per recuperare l’output strutturato da una sessione. L’output strutturato viene restituito nel campo structured_output.
Quando utilizzi l’applicazione web Devin, puoi visualizzare rapidamente l’output strutturato in qualsiasi momento premendo ⌘ + I (Command+I).

​
Best practice

  • Includi la definizione 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
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 [email protected].