Passer au contenu principal
La sortie structurée est comme le bloc-notes de Devin : il met à jour ses notes au fur et à mesure qu’il travaille, et vous pouvez les consulter à tout moment. Actuellement, vous ne pouvez pas forcer Devin à mettre à jour ses notes, mais vous pouvez demander à voir ce qu’il a écrit jusqu’à présent.

Suivi de la progression

Recevez des mises à jour sur la progression de Devin lors de tâches de longue durée

Intégration aux applications

Redirigez les analyses et résultats de Devin vers vos applications avec un JSON cohérent.

Demander un résultat structuré

Pour utiliser un résultat structuré, incluez le schéma JSON souhaité dans le prompt lors de la création d’une session. Veillez à demander à Devin de mettre à jour le résultat structuré dès qu’un événement pertinent se produit.
  • Revue de PR
  • Mises à jour d'avancement
  • Résultats des tests
  • Implémentation de fonctionnalité
{
  "prompt": "Review this PR and provide updates in this format. Please update the structured output immediately whenever you find new issues, have suggestions, or change your approval status:\n{
    "issues": [
      {
        "file": "src/App.tsx",
        "line": 42,
        "type": "bug",
        "description": "Memory leak in useEffect cleanup"
      }
    ],
    "suggestions": [
      "Add error handling for API calls",
      "Split component into smaller parts"
    ],
    "approved": false
  }"
}
Format simple pour les revues de PR et l’analyse de code.

Récupérer la sortie structurée

Utilisez ce point de terminaison pour récupérer la sortie structurée d’une session. La sortie structurée est retournée dans le champ structured_output.
Lorsque vous utilisez l’application web Devin, vous pouvez à tout moment afficher rapidement la sortie structurée en appuyant sur ⌘ + I (Command+I).

Bonnes pratiques

  • Inclure la définition du schéma dans le message initial
  • Définir la fréquence de mise à jour attendue (par exemple, « Veuillez mettre à jour le résultat structuré après avoir ajouté chaque nouveau composant au site web »)
  • Documenter clairement les types de valeurs et les formats
  • Utiliser des noms de champs clairs et descriptifs pour que Devin sache quoi écrire
  • Inclure des valeurs d’exemple dans votre schéma
  • Utiliser des intervalles de 10 à 30 secondes pour l’interrogation (polling) afin d’éviter de surcharger l’API Devin
  • Arrêter l’interrogation lorsque la session est terminée ou qu’une erreur survient
N’oubliez pas que Devin met à jour le résultat structuré selon son propre rythme : vous ne pouvez pas forcer une mise à jour, mais vous pouvez demander à voir les dernières notes à tout moment.
Pour toute question concernant l’utilisation du résultat structuré ou pour signaler un problème, envoyez un e-mail à [email protected].