Output strutturato

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.

{
  "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.

{
  "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.

{
  "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 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 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

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.

Get Started

Essential Guidelines

Onboarding Devin

Working with Devin

Product Guides

Integrations

Admin

Release Notes

Aggiornamenti sui progressi

Integrazione con le applicazioni

Richiedere output strutturato

Recuperare l’output strutturato

Best practice

Aggiornamenti sui progressi

Integrazione con le applicazioni

​Richiedere output strutturato

​Recuperare l’output strutturato

​Best practice

Richiedere output strutturato

Recuperare l’output strutturato

Best practice