agently-output-control

Agently 出力制御

このスキルは、モデルがどのような形で返すべきか、そしてその形をどのようにして信頼性を保つかが問われる場合に使用します。

ユーザーが .output(...) や ensure_keys と言う必要はありません。安定した JSON ライクなフィールド、構造化されたレポート、または機械可読なセクションのリクエストは、ここにルーティングされるべきです。

ネイティブ優先のルール

• 構造化出力がストリーミングされたり、再利用されたり、非同期境界を越えて提供されたりする場合は、デフォルトで非同期優先のレスポンス消費とします
• スキーマが安定していてリクエストファミリー間で共有される場合は、.request.output のようなプロンプト設定が所有する出力コントラクトを優先します
• スキーマが動的、探索的、またはコードの近くに保つほうが容易な場合は、機械可読な結果に対して .output(...) を優先します
• 必須フィールドを強制する必要がある場合は、ensure_keys を優先します
• 下流のシステム、ワークフローの分岐、または後続のモデルステップが結果を消費する場合は、出力スキーマを明示的に保ちます

アンチパターン

• .output(...) がすでにコントラクトを所有しているのに、JSON ポストプロセッサを手書きしないでください
• プロンプト設定が一度だけ所有できるのに、安定した共有スキーマを Python で再構築しないでください
• ensure_keys を確認する前に、欠落したキーに対するカスタムリトライループを構築しないでください
• 呼び出し側がすでに非同期対応可能なのに、デフォルトで同期のみの結果処理にしないでください

次に読む

• references/overview.md