Skip to main content
Utilisez structuredOutput pour contraindre l’agent à respecter un schéma zod. Appuyez-vous systématiquement sur Output.object({ schema: z.object(...) }) pour fournir les bonnes indications aux modèles OpenAI/Google et récupérer un typage automatique.
  • Output.object fournit une syntaxe fluide pour décrire la réponse attendue.
  • Les descriptions du schéma sont transmises au modèle pour améliorer la précision.
  • En cas de parsing invalide, le SDK lève une exception que vous pouvez intercepter.

Extraction ciblée

Recommandations

  • Préférez agent.generate pour la génération structurée : le mode streaming reste expérimental.
  • Logguez les erreurs de parsing pour affiner vos prompts ou relancer une tentative.
  • Distinguez les sorties « strictes » (identifiants, métadonnées) des contenus libres (résumés, réponses longues).

Modèles Scaleway

L’API compatible OpenAI de Scaleway applique encore les schémas côté client. La librairie infère désormais automatiquement AgentStructuredOutput à partir de votre schéma Zod, vous pouvez donc conserver exactement la même écriture :
codeSchema est automatiquement typé comme AgentStructuredOutput<typeof schema>, ce qui garantit la compatibilité Scaleway tout en conservant la même DX qu’avec OpenAI/Google.
Lorsque vous ciblez un provider non-OpenAI sans outil, AI Kit appelle désormais directement generateObject. Les messages (texte ou image) que vous passez à l’agent suffisent donc pour alimenter experimental_output, même sans rappeler au modèle comment formater la réponse.