lenses.runモジュール 26Governance lenses
渡したデータに固定のチェックを実行し、毎回同じ答えとして、証拠付きの合格または不合格を得ます。
lenses.run は、インストール済みのレンズ1つを、送信した input に対して評価します。レンズは決定的なルールで、個人データのパターン、重複するリース、スコープ外のリクエストなどを扱います。結果には所見、証拠、ルールと入力それぞれのダイジェストが含まれます。モデルは関与しません。
lenses.runモジュール 26渡したデータに固定のチェックを実行し、毎回同じ答えとして、証拠付きの合格または不合格を得ます。
lenses.run は、インストール済みのレンズ1つを、送信した input に対して評価します。レンズは決定的なルールで、個人データのパターン、重複するリース、スコープ外のリクエストなどを扱います。結果には所見、証拠、ルールと入力それぞれのダイジェストが含まれます。モデルは関与しません。
レンズはワークスペース自身の記録を読みません。確認したいリース、マンデート、テキストを取り出して input として送ってください。ルールの種類は3つで、4つ目にはコードの変更が必要です。
installIdinstall または list から得ます。inputparametersinput 内のすべての文字列を走査し、メール、米国の社会保障番号、電話番号のパターンを探します。所見にはパスと件数が含まれ、一致した値は保持されません。
input.leases を受け取ります。各リースには resource、holder、開始と終了があります。保持者が異なり、時間が重なる同一リソースの2つのリースを指摘します。
共有デモワークスペースでデモ用キーを使って実行します。中身は誰でも見られるため、非公開の情報は送らないでください。 lenses.runの資料
実行を押すと、左のリクエストが共有デモワークスペースに送信されます。
共有デモワークスペースでデモ用キーを使って実行します。中身は誰でも見られるため、非公開の情報は送らないでください。
APIが受け付ける形のリクエストと、モジュールが返す形のレスポンス例です。
POST /api/v1/acp/lenses/run Authorization: Bearer av_workspace_•••• Content-Type: application/json { : , : }
下書きのペイロードに pii_presence を実行します。所見には各ヒットのJSONパスと件数が示され、一致したテキストは保存されません。
リースのリストを lease_overlap に送ります。同じリソースを重なる時間に2人が保持している場合は、両方のリース参照を持つ対の証拠として返ります。
マンデートの actions と resources を1つのリクエストと一緒に送ります。スコープ外のリソースは、問題のフィールドのパスを示して不合格になります。
モジュールは、狭い範囲について強く保証します。保証されることだけを頼ってください。
input からは、同じ所見、証拠、digest が得られます。時刻もモデルも読まないためです。pii_presence が記録するのはパターンが見つかった場所と回数で、一致したテキストではありません。definitionDigest により、それを生成したルールのバージョンを正確に示します。install、create、update にはProティア、publish にはScaleが必要です。run にティアの要件はありません。install と uninstall には管理者ロールも必要です。
ワークスペースのAPIキーをBearerトークンとして認証します。ベースURLは https://api.intramedial.com です。
/api/v1/acp/lenses/catalogレンズのカタログを一覧します。/api/v1/acp/lenses/listこのワークスペースの定義とインストールを一覧します。statuspass、あれば fail。findingspii.present、lease.overlap、mandate.out_of_scope などの code、message、path があります。evidencekind、path、detail オブジェクト。definitionDigestinputDigestinput と parameters のSHA-256ダイジェスト。同じデータなら同じダイジェストになります。digestid と executedAt は含まれません。input.mandate(actions、resources)と input.request(action、resource)を受け取ります。マンデートの範囲外のリクエストを指摘します。* と末尾の * が一致します。
catalog は、組み込みのレンズと、ワークスペースに公開されたレンズを一覧します。各エントリにルールの種類が示されます。
install はカタログのエントリを、無効なインストールとしてワークスペースにコピーします。activate で有効にします。無効なインストールを実行すると409が返ります。
installId と、ルールに合う形の input を送信します。input がない、または形式が不正な場合は、問題点を示す400になります。
結果は保存されます。results は resultId で1件、または installId のすべての結果を返します。
{
"result": {
"id": "result_3f9a",
"installId": "install_7c2e",
"definitionId": "lens_builtin_lease_overlap",
"version": 1,
"definitionDigest": "sha256:5b1d0c9e7a42",
"inputDigest": "sha256:e07a93b1c6d8",
"status": "fail",
"findings": [
{
"code": "lease.overlap",
"message": "overlapping leases for repo:payments/main",
"path": "$.leases"
}
],
"evidence": [
{
"kind": "lease_overlap",
"path": "$.leases",
"detail": {
"resource": "repo:payments/main",
"left": "l1",
"right": "l2"
}
}
],
"digest": "sha256:a2c4e8f016b3",
"executedAt": "2026-11-01T09:12:00.000Z"
}
}結果の definitionDigest と inputDigest により、レビュアーは同じデータでチェックを再実行して比較できます。
coordination.admit です。レンズはデータを報告するだけで、何もブロックしません。coordination.lease が保持し、レンズが確認するのは渡されたリストです。detection.run を使ってください。results で後からIDで取得できます。create と update は新しい定義バージョンを保存します。選べるのは既存のルールの種類から選ぶことと、名前、説明、パラメーターのスキーマを付けることだけです。
publish はカスタム定義を、キュレーションされていないコミュニティのエントリとしてカタログに載せます。組み込みのエントリがキュレーション済みです。
activate と deactivate には policies.approve が必要です。create と update には policies.propose が必要です。
重複には異なる保持者が必要です。1人の保持者が同じリソースに重なる2つのリースを持っていても、所見にはなりません。
pii_presence、lease_overlap、mandate_scope の3つです。未対応の種類は400を返します。resource、holder、開始、それより後の終了が必要です。不正なリースは、そのインデックスを示す400を返します。mandate_scope には、mandate.actions、mandate.resources、request.action、request.resource が文字列として必要です。/api/v1/acp/lenses/install/api/v1/acp/lenses/activateインストールを有効にします。/api/v1/acp/lenses/run送信した input に対してインストールを評価します。/api/v1/acp/lenses/results保存済みの結果1件、またはインストールのすべての結果を読み取ります。coordination.lenses.runエージェントからレンズを実行します。coordination.lenses.resultsエージェントから保存済みの結果を読み取ります。coordination.lenses.catalogエージェントからカタログを一覧します。coordination.lenses.activateエージェントからインストールを有効化します。detection.run07civics.settings23Workspace constitutionこのワークスペースで、緊急度ごとに、エージェントの質問へ人が答えるべき速さと当番を設定します。change-trains.list24Staged change trains変更をまずフリートの一部に展開し、計測したシグナルで確認しながら、段階的に進めます。packs.list25Signed pack registry外部からエージェント、付与、ドリルのパックを取り込み、誰が署名したか、途中で1バイトでも変わったかを把握します。attestation.policy27Artifact build attestationポリシーのスナップショットと検出器パックで受け入れるビルダーを決め、信頼できる作者が署名しても別のビルドで作られたものは拒否します。pack-revenue.balances28Pack revenue ledger誰がいくら稼ぎ、いくら未払いか。支払う前に、最小通貨単位まで1円も漏れなく確認できます。