要点
- 画像はリクエスト最上位の assets に一度だけ登録し、そのキーを state、質問の instructions、criteria のどこかに書くと、その位置に画像が入る。Jev 1.13 と 1.14 の両方が対応し、TypeSafe-Danger-Zone-Images ヘッダーが必要
- Box は、画像の中で対象がある位置を上下左右の4辺(幅・高さに対する0〜1の割合)と confidence で返す新しい質問タイプ。criteria は取らず、jev-preview か jev-1.14.0 を指定する
- 受け付けるのは PNG と JPEG の静止画で、1枚16MiB、リクエスト本体32MiBまで。範囲外の画像は縮小されずに拒否され、1枚でも拒否されるとリクエスト全体が失敗する
何が変わるか
写真やスクリーンショットを文章に書き起こさず、そのまま判定に使えるようになった。ただし公式は画像と Box を本番向けの水準にはまだ達していない実験機能と位置づけ、形式・上限・精度はリリースごとに変わりうると明記している。同じ画像を複数の質問で使うなら、各質問に埋め込まず state に1回置いてパスで参照すると、トークンもサイズ上限も節約できるとドキュメントにある。試作や検証に使い、本番の判定に組み込むのは様子を見てからにしたい。
関連ガイド
- Jev の3つの質問タイプ(Choice / Score / Noul)の書き方と選び方
- Jev の state の設計: 文字列・オブジェクト・配列の使い分け
- Jev の REST API の使い方とエラーコード
出典・参考リンク
- 一次情報 Images - TypeSafe Docs
- 一次情報 Box - TypeSafe Docs