KeylessAI Documentation

AI Action Governance Kernel -- すべてのAIアクション（広告予算、決済、デプロイ）は、実行前にインテントベースのガバナンスを通過します。

How it works

KeylessAIは、すべてのAIアクションに対して厳格な10ステップのパイプラインを適用します:

1. Intent Declaration — AIエージェントが実行したいアクションを宣言します（例: 広告予算を$5,000増額）
2. Policy Evaluation — 7つのポリシールールを検査: 権限、予算上限、レート制限、リスク閾値
3. Approval Gate — 高額または高リスクなアクションは人間のレビュアーに回送されます
4. Atomic Execution — 冪等性ロックにより、アクションは厳密に1回だけ実行されます
5. Audit Ledger — すべてのステップが完全なトレーサビリティで記録されます

Core concepts

Intent

すべてのアクションはインテントとして始まります -- AIが何をしたいかの宣言で、アクションタイプ、金額、ターゲットなどの構造化されたメタデータを含みます。インテントは実行前にリスクスコアリングとポリシー評価を受けます。

Policy

ポリシーはすべてのインテントに対して自動的に評価されます。ルールには権限チェック、予算上限、レート制限、リスク閾値、時間帯制限が含まれます。auto-policy機能は$1,000を超えるすべてのアクションに人間の承認を要求します。

Approval

ポリシーが承認を必要とする場合、インテントは一時停止され、人間のレビュアーに通知されます。承認には設定可能な有効期限があります。SDKはasync承認フロー用に waitForApproval() を提供します。

Execution

実行はアトミックかつ冪等です。KernelはPostgreSQLアドバイザリロックを取得し、ポリシーを再チェックし、予算を検証し、コネクタ層で実行し、結果を書き込みます -- すべて部分的な状態を許さない単一パイプラインで行われます。

Ledger

すべてのインテント、実行、承認、ポリシー判定は監査台帳に記録されます。エージェント、日付範囲、ステータス、または個別のインテントでクエリし、完全なトレーサビリティを確保できます。

Quick install

# SDKをインストール
npm install @keylessai/sdk

# 初期化
import { KeylessAI } from '@keylessai/sdk';

const keyless = new KeylessAI({
  apiKey: 'ka_live_xxx',
  orgId: 'your-org-id',
  agentId: 'your-agent-id',
});

// ガバナンス付きアクションを実行
const result = await keyless.execute({
  action: 'ads.budget_increase',
  amount: 5000,
  target: { campaign: 'camp_abc' },
});