開発者プラットフォーム

ガバナンス済みランタイムの上に構築する。

ガバナンス済み AI エージェントプラットフォームのための、型付き SDK・REST API・CLI。エージェントの登録、アクションの提案、ポリシーの作成、オントロジーの照会、改ざん検知可能な Trust Ledger の参照ができます。コンソールを保護するのと同じゲートが、すべてのリクエストに適用されます。

ウェイトリストに登録アーキテクチャを見る

@cortex/client SDK · REST · CLI · Webhook · サンドボックス

agent.tspolicy.tscurl
例
// 一度書くだけ。すべての実行がゲートを通り、すべてのアクションが証明可能。
import { Cortex } from "@cortex/client";
const cortex = new Cortex({ apiKey, tenantId });
// 高リスクのアクションを提案 — 判断するのはゲート。
const res = await cortex.actions.propose({
key: "refund.issue",
input: { amount: 5000 },
});
pending_approval{ status: "pending_approval", riskLevel: "high" }
// 高リスクのアクションは管理者の承認待ち。承認したら、
// 署名付きレシートを読む — チェーンに対しオフラインで検証可能。
audit/verify ▸ { ok: true, brokenAtSeq: null, head: { seq: 1042, hash: "0x9f3a…c1" } }
クイックスタート

インストールからガバナンス判定まで、3ステップ。

SDK をインストールし、テナントに対して認証し、最初のガバナンス済みアクションを提案します — すべての呼び出しは、オフラインで検証できる Trust Ledger に記録されます。以下のスニペットは説明用の例です。

  1. 01

    @cortex/clientをインストール

    型付きSDKをプロジェクトに追加します。同じREST APIと同じフェイルクローズドのゲートの上に載る、薄いクライアントです。

  2. 02

    認証する

    テナントスコープのAPIキーとtenantIdでクライアントを生成します。すべての呼び出しはデータ経路上で自テナントに束縛され、テナントをまたぐ読み取りは発生しません。

  3. 03

    統制されたアクションを実行し、判定を読む

    アクションを提案します。低リスクの実行はそのまま実行され、高リスクまたは承認が必要なアクションはpending_approvalとして保留されます。判定を読み、レシートを検証してください。

インストール例
# 01 · 型付き SDK をインストール
npm i @cortex/client
 
# 02 · 認証（API キー + テナント）
import { Cortex } from "@cortex/client";
const cortex = new Cortex({
  apiKey: process.env.CORTEX_KEY,
  tenantId: process.env.CORTEX_TENANT,
});
ガバナンス済みアクションを実行例
// 03 · propose — 判定を下すのはゲート
const res = await cortex.actions.propose({
  key: "refund.issue",
  input: { amount: 5000 },   // 高リスク
});
 
// → { status: "pending_approval", riskLevel: "high" }
// 低リスクのアクションは { status: "executed" } を返す
コアコンセプト

あらゆる統合の土台となる6つの概念。

これらのインターフェースは、いずれも同じガバナンス済みランタイム上の薄いクライアントです。概念を押さえたうえで、各機能ページで全体像をご確認ください。

統制ランタイムとゲート
  • すべての実行が同じ順序のゲートを通過
  • 既定は拒否 — フェイルクローズ
  • 安定したコード: 402 · 403 · 409 · アーキテクチャ
オントロジーと権限
  • 型付きのエンタープライズオブジェクトモデル
  • オブジェクト単位・プロパティ単位の RBAC（none/read/write）
  • read 未満は読み取り時にマスク · オントロジー
Action Fabric
  • リスクレベル付きの名前付きアクション
  • dry-run → propose → approve → execute
  • 変更不能な呼び出し台帳 · action fabric
Trust Ledgerと来歴
  • ハッシュチェーンで連結された改ざん検知可能な監査
  • オフラインで検証できる署名付きレシート
  • 10 ホップの系統 · trust ledger
Agent IAM
  • エージェントは統制対象のアイデンティティ
  • オーナー · リスク階層 · 有効期限 · 許可モデル
  • 期限切れのアイデンティティ → 403 · agent IAM
Solution Packs
  • オントロジー・ポリシー・アクションを 1 つの成果物に
  • 署名 · 検証 · インポート時に差分表示
  • 自分のテナントに再デプロイ · packs
API とリソース

実際に扱うことになるリソース領域。

すべてのガバナンス済みインターフェースには、REST、型付きの @cortex/client SDK、または CLI からアクセスできます。以下は各リソース領域の役割であり、網羅的なエンドポイントリファレンスではありません。詳細は各カードからご覧ください。

エージェントとアイデンティティ
client.agentIdentities

エージェントを、オーナー・リスク階層・有効期限・許可モデル/アクションを備えた統制対象のアイデンティティとして登録します。期限切れまたは停止中のアイデンティティは実行時に拒否されます（403）。

詳しく見る
アクション
client.actions

リスクレベルと承認ポリシーを備えた名前付きアクション。Dry-run → propose → approve/deny → execute → compensate の各ステップが、証跡パックとともに変更不能な呼び出し台帳に記録されます。

詳しく見る
ポリシー
client.governance

ルールを作成し、リリース前に判断をシミュレーション（ルール単位のトレース付き）したり、候補のルールセットに対してゴールデンポリシーテストを実行したりできます。最も制限の強い効果が優先されます。

詳しく見る
オントロジーと権限
client.ontology

オブジェクト単位・プロパティ単位の RBAC を備えた、型付きのエンタープライズオブジェクトモデル。権限は none / read / write に解決され、読み取りでは read 未満のプロパティがマスクされ、書き込みは型ごとにゲートされます。

詳しく見る
監査と検証
GET /v1/audit/verify

ハッシュチェーンで連結された、改ざん検知可能な監査台帳。verify は指定範囲について { ok, brokenAtSeq, head } を返し、head は外部アンカリング用に現在のチェーンヘッドを返します。

詳しく見る
Solution Packs
client.packs

オントロジー型・ポリシー・アクションを、署名付きでバージョン管理された成果物にまとめます。verify は hashOk + signatureOk を確認し、import は差分をプレビューしたうえで呼び出し側自身のテナントに適用します。

詳しく見る
REST API@cortex/client SDKCLIWebhook とイベント
統合の方法

5つのインターフェース、1つのガバナンス済みランタイム。

API、SDK、CLI、Webhook は、いずれも同じフェイルクローズ・ゲート群の上の薄いクライアントです — アイデンティティ、予算、ガードレール、レジストリ、Control Tower、実行、出力ガード、監査。ガバナンスされていない裏口は存在しません。

REST API

ガバナンス済みのあらゆるインターフェースを HTTPS 経由で操作できます。アクションの登録、提案と承認、オントロジーの照会、ガバナンスシミュレーションの実行、Trust Ledger の参照まで。コンソールを保護するのと同じゲートが API も保護します。

テナントスコープ · Bearer トークン
  • テナントスコープはデータ経路で強制
  • 管理者専用ルート（approve · deny · pack import）はサーバー側でゲート
  • 分岐に使える安定したステータスコード — 402 · 403 · 409
@cortex/client SDK

REST API 上の型付き TypeScript クライアント。エージェント、アクション、ガバナンス、オントロジー、監査、パックを厳密に型付けされたリソースとして扱え、テナントスコープとゲートの挙動は生の API と同じです。

npm i @cortex/client · ESM + types
  • client.actions · client.governance · client.packs
  • client.ontology.permissions · client.agentIdentities
  • すべての呼び出しに Token + tenantId
CLI

ターミナルと CI からガバナンスを出荷。署名済み Solution Packs のエクスポートと検証、リグレッションゲートとしてのポリシーテスト実行、Trust Ledger の確認まで、パイプラインを離れずに行えます。

スクリプト化可能 · CI フレンドリー
  • ルール変更を出荷する前にポリシーテストを実行
  • 署名済みパックのエクスポートと検証（hashOk · signatureOk）
  • 台帳チェーンをオフラインで検証
Webhook とイベント

Cortex は、ガバナンス済みのライフサイクルイベント（ActionExecuted、ActionFailed、承認の決定）を、Trust Ledger を封印するのと同じプラットフォームイベント経路から発行します。購読すれば、改ざん検知可能な監査証跡と突き合わせて照合できます。

イベント駆動 · 台帳で封印
  • アクションのライフサイクル: proposed · approved · executed · compensated
  • すべてのイベントは記録と同時にハッシュチェーンへ封印
  • 台帳のシーケンス（seq）で照合
サンドボックスとクイックスタート

サンプルのオントロジー・ポリシー・アクションを投入できる、ガバナンス済みテナント。本番に触れることなく、最初のゲート付きアクションを実行し、検証可能な実際の Trust Ledger を参照できます。

テナント分離 · 本番への影響ゼロ
  • サンプルのオントロジー・ポリシー・アクションを投入
  • まず dry-run — 入力を検証し、副作用なし
  • すべてのゲート判定を呼び出し台帳で確認
Policy-as-Code

アプリと同じようにガバナンスをバージョン管理。allow / require-approval / deny のルールを記述し、出荷前に判定をシミュレートし、CI のゴールデンポリシーテストで変更をゲートできます。

シミュレート · テスト · 昇格
  • 最も厳しいものが優先: deny > require_approval > allow
  • simulate() はルールごとの判定トレースを返す
  • 出荷前のリグレッションゲートとして tests.run()
ログではなく、証明可能

台帳をオフラインで検証する。

Trust Ledger はハッシュチェーンで連結され、各レコードが直前のレコードを封印します。verifyChain はチェーンを再計算して { ok, brokenAtSeq } を返し、挿入・編集・削除・並べ替えがあれば ok は false になります。結果レシートはデタッチ署名で、公開された鍵で検証できます。そのため第三者は、Cortex のデータベースを信頼しなくても実行があったことを確認できます。このスニペットは説明用の例です。

  • チェーンの整合性: verifyChain(records) → { ok, brokenAtSeq }
  • 署名付きレシート: verifyReceipt(claims, sig, key)、定数時間で比較
  • 現在は HMAC-SHA256。公開可能な Ed25519 検証鍵がドキュメント化された次の段階です
Trust Ledgerを詳しく見るアーキテクチャを見る
オフラインで検証例
import {
  verifyChain, verifyReceipt,
} from "@cortex/provenance";
 
// 1 · ハッシュチェーンを再計算
const v = verifyChain(records);
// → { ok: true, brokenAtSeq: null }
 
// 2 · 署名付きの結果レシートを検証
const valid = verifyReceipt(
  claims, signature, verifyKey,
);
// → true   (改ざんされていれば false)
さらに深く

構築の土台となるランタイムを理解する。

開発者向けインターフェースは、プラットフォーム全体の上に位置します。ゲートがどう組み合わさるかを確認し、ガバナンス済み機能をエンドツーエンドで探索してください。

アーキテクチャ

コンソール、ランタイムゲート、約22のマイクロサービス、そして Postgres 上の単一のオントロジーと Trust Ledger — すべての API 呼び出しが通る階層型システムです。

プラットフォーム

Action Fabric、Agent IAM、オントロジー、監督モード、MCP ゲートウェイ、Trust Ledger — ガバナンス済み機能のすべてに、API と SDK からアクセスできます。

初日からガバナンス済みエージェントを構築する。

API・SDK・CLI のガイド付きツアーを受け、最初のゲート付きアクションが検証可能な Trust Ledger に記録されるところをご覧ください。

ウェイトリストに登録エンジニアリングに相談
開発者向けドキュメント — API・SDK・CLI | Cortex AI OS