Content-Type: application/json で POST https://bastion-guardian-api.starfort.io/v1/guard/api を呼び出します。
フィールド
リクエストでは camelCase（
processType）を使用します。これらは本番 API が期待するフィールド名です。processType
processType は Guardian が定義する自由形式のラベルであり、固定された列挙型ではありません。ほとんどの Guardian は input（入力時のリクエストをガード）と output（出力時のモデルレスポンスをガード）を宣言しますが、Guardian はサポートする任意の名前を宣言できます。
- 大文字小文字を区別しません — 値はマッチング前にトリムされて小文字化されるため、
"input"、"INPUT"、" Input "は同じ呼び出しです。 - 値は呼び出される Guardian がサポートするもののいずれかでなければなりません。 そうでない場合、呼び出しは事前検証中に拒否され、エラーメッセージにサポートされているプロセスタイプが一覧表示されます。エラーと状態を参照してください。
- 一部のプロセスタイプはポリシー不要です（Guardian がそれらに対して互換性のあるポリシータイプを宣言しません）。このようなプロセスタイプの呼び出しは Guard Policy を伴わないため、評価する対象がなく、検査なしで
PASSを返します。
メッセージのロール — すべてのメッセージが検査されます
Guardian はrole に関係なく、送信されたすべてを評価します。PII ルールはすべてのメッセージの各コンテンツパート（user、assistant、system、その他のロール）に対して実行されるため、assistant の応答や system プロンプトに含まれる機微情報も、user 入力と同じようにマスクまたはブロックされます。Topic ポリシーは、system メッセージを含むマージされた会話全体に対して、リクエストを一度だけ評価します。
検査をスキップするロールはありません。ガードしたい会話をそのまま送信してください。
検査制限 — Guardian が単一のポイントで強制
プロジェクトに設定された検査制限（テキスト長・ファイルサイズ）は、v1.4 からは Guardian が単一のポイントで強制します。ゲートウェイはプロジェクトが定めた制限値を Guardian に引き渡すだけで、Guardian がリクエストの最上位の入力だけでなく、ファイルから抽出されたテキスト、アーカイブ内部のメンバーまで、自身が扱うすべてのコンテンツに同じ制限を適用します。そのため制限違反はどの段階で検出されても一貫した Guardian の拒否として現れ、違反したリクエストはエラーとして拒否されます。 これとは別に、ゲートウェイにはいかなる設定とも無関係なプラットフォームの入力受信上限（リクエストボディサイズに対するインフラ保護ライン）があります — プロジェクトの検査制限は、その範囲内で自由に設定できます。Opticon トレーシング（オプション）
opticon オブジェクトは、その呼び出しに対して Starfort が記録するトレースにトレーシングメタデータを付加します。
指定したフィールドに加えて、Starfort は各トレースを自動的に補強します。トレースの名前は Project Guardian の名前になり、ルートの
action、各 policy_type:action / policy_name:action、および API キーの名前がタグとして追加されます。processType、マスクされた API キー識別子、および解決されたモデル構成はメタデータになり、ポリシーごとの検出件数はスコアとして記録されます。キーが競合した場合はシステム値が優先されます。トレーシングはベストエフォートであり、呼び出しをブロックすることは決してありません。Opticon モニタリングを参照してください。
messages 内のマルチモーダルコンテンツ（画像、音声、ファイル、動画）については、マルチモーダル入力を参照してください。