APIリファレンス¶
このドキュメントは、SymbiontランタイムAPIの包括的なドキュメントを提供します。Symbiontプロジェクトは、異なるユースケースと開発段階向けに設計された2つの独立したAPIシステムを提供します。
概要¶
Symbiontは2つのAPIインターフェースを提供します：
- ランタイムHTTP API - 直接的なランタイム操作、エージェント管理、ワークフロー実行のための完全なAPI
- ツールレビューAPI（本番環境） - AI駆動のツールレビューと署名ワークフロー用の包括的で本番対応API
ランタイムHTTP API¶
ランタイムHTTP APIは、ワークフロー実行、エージェント管理、システム監視のためのSymbiontランタイムへの直接アクセスを提供します。すべてのエンドポイントは完全に実装されており、http-api featureが有効な場合に本番対応です。
ベースURL¶
認証¶
ヘルスチェック以外のランタイム経路には Bearer 認証が必要です。非公開の API キーファイル、または従来の運用者トークン SYMBIONT_API_TOKEN を設定してください。
保護されたエンドポイント：
- /api/v1/agents/* のすべてのエンドポイントは認証が必要
- 公開されるのはヘルスチェックのみです。ワークフローの送信とメトリクスの取得には管理者権限が必要です。
利用可能なエンドポイント¶
ヘルスチェック¶
現在のシステムヘルスステータスと基本的なランタイム情報を返します。
レスポンス（200 OK）：
{
"status": "healthy",
"uptime_seconds": 3600,
"timestamp": "2024-01-15T10:30:00Z",
"version": "1.0.0"
}
レスポンス（500 内部サーバーエラー）：
{
"status": "unhealthy",
"error": "Database connection failed",
"timestamp": "2024-01-15T10:30:00Z"
}
利用可能なエンドポイント¶
ワークフロー実行¶
管理者は workflow_id に DSL ソースを送信し、parameters は実行入力になります。agent_id を指定すると登録を作成または置換し、省略すると新しい ID を割り当てます。エージェントに限定されたキーは 403 ADMIN_REQUIRED となり、登録済みソースを /agents/{id}/execute から実行できます。queued は受付を示します。/agents/{id}/history の execution_id で実際の結果を確認してください。詳細な仕様を参照してください。
DSL でサンドボックスを省略した場合、登録の既定値は Docker/Tier1 のままです。
with sandbox = "landlock" はネイティブの監視付きバックエンドを明示的に選択します。
Landlock はコンテナまたは VM ティアの要件を満たしません。
リクエストボディ：
{
"workflow_id": "agent report() { with sandbox = \"docker\" {} }",
"parameters": {},
"agent_id": null
}
レスポンス（200 OK）：
{
"status": "queued",
"workflow_id": "agent report() { with sandbox = \"docker\" {} }",
"agent_id": "19b183f7-97c4-4e42-9c62-5e9c940bfae3",
"execution_id": "c7022f13-7140-4a09-8e30-b1941e0cbb32",
"metadata": {}
}
エージェント管理¶
すべてのエージェント管理エンドポイントは Authorization: Bearer <token> ヘッダーによる認証が必要です。
エージェント一覧¶
ランタイム内のすべてのアクティブエージェントのリストを取得します。
レスポンス（200 OK）：
エージェントステータス取得¶
特定のエージェントのスケジューラー上のステータスを取得します。CPU とメモリは null になり得ます。現在のスケジューラーにはエージェント単位のサンプラーがないため、内部エージェントと外部エージェントのいずれについても null を返します。クライアントはこれらの値を使用量ゼロとして提示してはなりません。
レスポンス（200 OK）：
{
"agent_id": "uuid",
"state": "Running",
"last_activity": "2024-01-15T10:30:00Z",
"resource_usage": {
"memory_bytes": null,
"cpu_percent": null,
"active_tasks": 1
},
"execution_mode": "Ephemeral"
}
active_tasks はスケジューラーが所有するタスクの数です。last_activity はリソースをサンプリングした時刻ではありません。Fleet Overview は、CPU とメモリが欠落している場合に Not sampled と表示します。個別にサンプリングされたワーカーの使用量と予約済み容量は、ワーカー容量で提供されます。これらのワーカーの値は、エージェント単位の合計ではありません。
新しいエージェント状態：
- running: エージェントが実行中のプロセスでアクティブに実行中
- ready: エージェントが初期化され実行準備完了
- waiting: エージェントが実行のためにキューに入っている
- failed: エージェント実行が失敗したかヘルスチェックが失敗
- completed: エージェントタスクが正常に完了
- terminated: エージェントがグレースフルまたは強制的に終了
エージェント作成¶
指定した設定で新しいエージェントを作成します。
リクエストボディ：
レスポンス（200 OK）：
エージェント更新¶
既存のエージェント設定を更新します。少なくとも1つのフィールドが必要です。
リクエストボディ：
レスポンス（200 OK）：
エージェント削除¶
既存のエージェントをランタイムから削除します。
レスポンス（200 OK）：
エージェント実行¶
POST /api/v1/agents/{id}/execute
Idempotency-Key: <UUID retained for retries>
Authorization: Bearer <your-token>
選択したエージェントの呼び出しを 1 件送信します。同じ UUID とリクエストを再利用すると、保存済みの完了結果、または active / unresolved / reconciled / conflict のいずれかの明示的な結果を取得できます。スケジューラーの再試行状態を参照してください。
リクエストボディ：
レスポンス（200 OK）：
エージェント実行履歴取得¶
特定のエージェントの実行履歴を取得します。
レスポンス（200 OK）：
{
"history": [
{
"execution_id": "uuid",
"status": "completed",
"timestamp": "2024-01-15T10:30:00Z"
}
]
}
エージェントハートビート¶
実行中のエージェントからハートビートを送信してヘルスステータスを更新します。
エージェントへのイベントプッシュ¶
イベントドリブン実行のために実行中のエージェントに外部イベントをプッシュします。
システムメトリクス¶
スケジューラー、タスクマネージャー、ロードバランサー、システムリソースをカバーする包括的なメトリクススナップショットを取得します。
レスポンス（200 OK）：
{
"timestamp": "2026-02-16T12:00:00Z",
"scheduler": {
"total_jobs": 12,
"active_jobs": 8,
"paused_jobs": 2,
"failed_jobs": 1,
"total_runs": 450,
"successful_runs": 445,
"dead_letter_count": 2
},
"task_manager": {
"queued_tasks": 3,
"running_tasks": 5,
"completed_tasks": 1200,
"failed_tasks": 15
},
"load_balancer": {
"total_workers": 4,
"active_workers": 3,
"requests_per_second": 12.5
},
"system": {
"cpu_usage_percent": 45.2,
"memory_usage_bytes": 536870912,
"memory_total_bytes": 17179869184,
"uptime_seconds": 3600
}
}
メトリクススナップショットは、ランタイムの MetricsExporter システムを使用してファイル（アトミックJSON書き込み）またはOTLPエンドポイントにもエクスポートできます。以下のメトリクスとテレメトリセクションを参照してください。
メトリクスとテレメトリ¶
Symbiontは複数のバックエンドへのランタイムメトリクスのエクスポートをサポートしています：
ファイルエクスポーター¶
メトリクススナップショットをアトミックJSONファイル（tempfile + rename）として書き込みます：
use symbi_runtime::metrics::{FileMetricsExporter, MetricsExporterConfig};
let exporter = FileMetricsExporter::new("/var/lib/symbi/metrics.json");
exporter.export(&snapshot)?;
OTLPエクスポーター¶
OpenTelemetry互換の任意のエンドポイントにメトリクスを送信します（metrics featureが必要）：
use symbi_runtime::metrics::{OtlpExporter, OtlpExporterConfig, OtlpProtocol};
let config = OtlpExporterConfig {
endpoint: "http://localhost:4317".to_string(),
protocol: OtlpProtocol::Grpc,
..Default::default()
};
コンポジットエクスポーター¶
複数のバックエンドに同時にファンアウトします -- 個別のエクスポート失敗はログに記録されますが、他のエクスポーターをブロックしません：
use symbi_runtime::metrics::CompositeExporter;
let composite = CompositeExporter::new(vec![
Box::new(file_exporter),
Box::new(otlp_exporter),
]);
バックグラウンドコレクション¶
MetricsCollector はバックグラウンドスレッドとして実行され、定期的にスナップショットを収集してエクスポートします：
use symbi_runtime::metrics::MetricsCollector;
let collector = MetricsCollector::new(exporter, interval);
collector.start();
// ... 後で ...
collector.stop();
スキルスキャン（ClawHavoc）¶
SkillScanner はロード前にエージェントスキルコンテンツの悪意のあるパターンを検査します。10の攻撃カテゴリにわたる40の組み込みClawHavoc防御ルールを同梱しています：
| カテゴリ | 数 | 重大度 | 例 |
|---|---|---|---|
| オリジナル防御ルール | 10 | Critical/Warning | pipe-to-shell, eval-with-fetch, rm-rf-pattern |
| リバースシェル | 7 | Critical | bash, nc, ncat, mkfifo, python, perl, ruby |
| 認証情報ハーベスティング | 6 | High | SSHキー、AWS認証情報、クラウド設定、ブラウザCookie、キーチェーン |
| ネットワーク窃取 | 3 | High | DNSトンネル、/dev/tcp、netcatアウトバウンド |
| プロセスインジェクション | 4 | Critical | ptrace、LD_PRELOAD、/proc/mem、gdbアタッチ |
| 権限昇格 | 5 | High | sudo、setuid、setcap、chown root、nsenter |
| シンボリックリンク / パストラバーサル | 2 | Medium | シンボリックリンクエスケープ、深いパストラバーサル |
| ダウンローダーチェーン | 3 | Medium | curl保存、wget保存、chmod実行 |
完全なルールリストと重大度モデルについてはセキュリティモデルを参照してください。
使い方¶
use symbi_runtime::skills::SkillScanner;
let scanner = SkillScanner::new(); // すべての40デフォルトルールを含む
let result = scanner.scan_skill("/path/to/skill/");
if !result.passed {
for finding in &result.findings {
eprintln!("[{}] {}: {} (line {})",
finding.severity, finding.rule, finding.message, finding.line);
}
}
デフォルトと並行してカスタム拒否パターンを追加できます：
let scanner = SkillScanner::with_custom_rules(vec![
("custom-pattern".into(), r"my_dangerous_pattern".into(),
ScanSeverity::Warning, "Custom rule description".into()),
]);
サーバー設定¶
ランタイムHTTP APIサーバーは以下のオプションで設定できます：
- デフォルトバインドアドレス:
127.0.0.1:8080 - CORSサポート: 開発用に設定可能
- リクエストトレーシング: Towerミドルウェア経由で有効
- フィーチャーゲート:
http-apiCargo featureの後ろで利用可能
フィーチャー設定リファレンス¶
クラウドLLM推論 (cloud-llm)¶
エージェント推論のためにOpenRouter経由でクラウドLLMプロバイダーに接続：
環境変数：
- OPENROUTER_API_KEY -- OpenRouter APIキー（必須）
- OPENROUTER_MODEL -- 使用するモデル（デフォルト：google/gemini-2.0-flash-001）
- OPENROUTER_REFERER -- 任意。OpenRouterリクエストの HTTP-Referer ヘッダーを設定（アプリ帰属）。未設定の場合は帰属なしのトラフィックとして扱われます。
- OPENROUTER_TITLE -- 任意。X-Title ヘッダーを設定します。OpenRouter app attribution を参照してください。
クラウドLLMプロバイダーは推論ループの execute_actions() パイプラインと統合されます。ストリーミングレスポンス、指数バックオフによる自動リトライ、トークン使用追跡をサポートしています。
スタンドアロンエージェントモード (standalone-agent)¶
クラウドネイティブエージェントのためにクラウドLLM推論を有効化するメタフィーチャー：
環境変数：
- OPENROUTER_API_KEY -- OpenRouter APIキー
Note: Composio MCP and SymbiBot integration were removed in this version due to security concerns — see SECURITY_AUDIT.md C3 for context.
Cedarポリシーエンジン (cedar)¶
Cedarポリシー言語を使用した正式認可：
Cedarポリシーは推論ループのGateフェーズと統合され、きめ細かな認可決定を提供します。ポリシーの例についてはセキュリティモデルを参照してください。
ベクトルデータベース設定¶
Symbiontはデフォルトの組み込みベクトルバックエンドとしてLanceDBを同梱しています -- 外部サービスは不要です。スケールされたデプロイメントでは、Qdrantがオプションのバックエンドとして利用可能です。
LanceDB（デフォルト）：
追加設定は不要です。データはランタイムと並んでローカルに保存されます。
Qdrant（オプション）：
[vector_db]
enabled = true
backend = "qdrant"
collection_name = "symbi_knowledge"
url = "http://localhost:6333"
環境変数：
- SYMBIONT_VECTOR_BACKEND -- lancedb（デフォルト）または qdrant
- QDRANT_URL -- QdrantサーバーURL（Qdrant使用時のみ）
高度な推論プリミティブ (orga-adaptive)¶
ツールキュレーション、スタックループ検出、コンテキストプリフェッチ、スコープ付きコンベンションを有効化：
完全な設定リファレンスについてはorga-adaptiveガイドを参照してください。
データ構造¶
コアタイプ¶
// ワークフロー実行リクエスト
WorkflowExecutionRequest {
workflow_id: String,
parameters: serde_json::Value,
agent_id: Option<AgentId>
}
// エージェントステータスレスポンス
AgentStatusResponse {
agent_id: AgentId,
state: AgentState,
last_activity: DateTime<Utc>,
resource_usage: ResourceUsage
}
// ヘルスチェックレスポンス
HealthResponse {
status: String,
uptime_seconds: u64,
timestamp: DateTime<Utc>,
version: String
}
// エージェント作成リクエスト
CreateAgentRequest {
name: String,
dsl: String
}
// エージェント作成レスポンス
CreateAgentResponse {
id: String,
status: String
}
// エージェント更新リクエスト
UpdateAgentRequest {
name: Option<String>,
dsl: Option<String>
}
// エージェント更新レスポンス
UpdateAgentResponse {
id: String,
status: String
}
// エージェント削除レスポンス
DeleteAgentResponse {
id: String,
status: String
}
// エージェント実行リクエスト
ExecuteAgentRequest {
// 現在は空の構造体
}
// エージェント実行レスポンス
ExecuteAgentResponse {
execution_id: String,
status: String
}
// エージェント実行記録
AgentExecutionRecord {
execution_id: String,
status: String,
timestamp: String
}
// エージェント実行履歴レスポンス
GetAgentHistoryResponse {
history: Vec<AgentExecutionRecord>
}
ランタイムプロバイダーインターフェース¶
APIは以下の拡張メソッドを持つ RuntimeApiProvider トレイトを実装しています：
execute_workflow()- 与えられたパラメータでワークフローを実行get_agent_status()- リアルタイム実行メトリクスを含む詳細ステータスを取得get_system_health()- スケジューラー統計を含む全体的なシステムヘルスを取得list_agents()- すべてのエージェント（実行中、キュー中、完了）をリストshutdown_agent()- リソースクリーンアップとタイムアウト処理でグレースフルシャットダウンget_metrics()- タスク統計を含む包括的なシステムメトリクスを取得create_agent()- 実行モード指定でエージェントを作成update_agent()- 永続化付きでエージェント設定を更新delete_agent()- 実行中プロセスの適切なクリーンアップでエージェントを削除execute_agent()- 監視とヘルスチェック付きで実行をトリガーget_agent_history()- パフォーマンスメトリクスを含む詳細な実行履歴を取得
スケジューリングAPI¶
すべてのスケジューリングエンドポイントは認証が必要です。cron featureが必要です。
スケジュール一覧¶
レスポンス（200 OK）：
[
{
"job_id": "uuid",
"name": "daily-report",
"cron_expression": "0 0 9 * * *",
"timezone": "America/New_York",
"status": "active",
"enabled": true,
"next_run": "2026-03-04T09:00:00Z",
"run_count": 42
}
]
スケジュール作成¶
リクエストボディ：
{
"name": "daily-report",
"cron_expression": "0 0 9 * * *",
"timezone": "America/New_York",
"agent_name": "report-agent",
"policy_ids": ["policy-1"],
"one_shot": false
}
cron_expression は6つのフィールドを使用します：sec min hour day month weekday（オプションの7番目のフィールドで年）。
レスポンス（200 OK）：
スケジュール更新¶
リクエストボディ（すべてのフィールドはオプション）：
{
"cron_expression": "0 */10 * * * *",
"timezone": "UTC",
"policy_ids": ["policy-2"],
"one_shot": true
}
スケジュールの一時停止 / 再開 / トリガー¶
POST /api/v1/schedules/{id}/pause
POST /api/v1/schedules/{id}/resume
POST /api/v1/schedules/{id}/trigger
Authorization: Bearer <your-token>
Idempotency-Key: <invocation-uuid>
手動実行には管理者トークンと Idempotency-Key ヘッダーの UUID が必要です。queued、保存済みの結果、または in_progress / unresolved / reconciled / conflict を返します。再試行では同じ UUID を使用してください。一時停止と再開は以下の応答形式を維持します。未解決の実行がある場合は再開できません。cron の復旧を参照してください。
レスポンス（200 OK）：
スケジュール削除¶
レスポンス（200 OK）：
スケジュール履歴取得¶
レスポンス（200 OK）：
{
"job_id": "uuid",
"history": [
{
"run_id": "uuid",
"started_at": "2026-03-03T09:00:00Z",
"completed_at": "2026-03-03T09:01:23Z",
"status": "completed",
"error": null,
"execution_time_ms": 83000
}
]
}
次回実行取得¶
レスポンス（200 OK）：
スケジューラーヘルス¶
スケジューラー固有のヘルスと統計を返します。
チャネルアダプターAPI¶
すべてのチャネルエンドポイントは認証が必要です。エージェントをSlack、Microsoft Teams、Mattermostに接続します。
チャネル一覧¶
レスポンス（200 OK）：
チャネル登録¶
リクエストボディ：
{
"name": "slack-general",
"platform": "slack",
"config": {
"webhook_url": "https://hooks.slack.com/...",
"channel": "#general"
}
}
サポートされているプラットフォーム：slack、teams、mattermost。
レスポンス（200 OK）：
チャネルの取得 / 更新 / 削除¶
GET /api/v1/channels/{id}
PUT /api/v1/channels/{id}
DELETE /api/v1/channels/{id}
Authorization: Bearer <your-token>
チャネルの開始 / 停止¶
レスポンス（200 OK）：
チャネルヘルス¶
レスポンス（200 OK）：
{
"id": "uuid",
"connected": true,
"platform": "slack",
"workspace_name": "my-team",
"channels_active": 3,
"last_message_at": "2026-03-03T15:42:00Z",
"uptime_secs": 86400
}
アイデンティティマッピング¶
GET /api/v1/channels/{id}/mappings
POST /api/v1/channels/{id}/mappings
Authorization: Bearer <your-token>
エージェントインタラクションのためにプラットフォームユーザーをSymbiontアイデンティティにマッピングします。
チャネル監査ログ¶
スケジューラー機能¶
リアルタスク実行： - 安全な実行環境でのプロセス生成 - 5秒間隔のリソース監視（メモリ、CPU） - ヘルスチェックと自動障害検出 - エフェメラル、永続、スケジュール、イベントドリブン実行モードのサポート
グレースフルシャットダウン： - 30秒のグレースフル終了期間 - 応答しないプロセスの強制終了 - リソースクリーンアップとメトリクス永続化 - キュークリーンアップと状態同期
拡張コンテキスト管理¶
高度な検索機能：
{
"query_type": "keyword|temporal|similarity|hybrid",
"search_terms": ["term1", "term2"],
"time_range": {
"start": "2024-01-01T00:00:00Z",
"end": "2024-01-31T23:59:59Z"
},
"memory_types": ["factual", "procedural", "episodic"],
"relevance_threshold": 0.7,
"max_results": 10
}
重要度計算： - アクセス頻度、最新性、ユーザーフィードバックによる多因子スコアリング - メモリタイプの重み付けとエイジ減衰係数 - 共有知識の信頼スコア計算
アクセス制御統合： - コンテキスト操作に接続されたポリシーエンジン - 安全な境界を持つエージェントスコープアクセス - きめ細かな権限を持つ知識共有
ツールレビューAPI（本番環境）¶
ツールレビューAPIは、AI駆動のセキュリティ分析と人間の監視機能を使用して、MCP（Model Context Protocol）ツールを安全にレビュー、分析、署名するための完全なワークフローを提供します。
ベースURL¶
認証¶
すべてのエンドポイントはBearer JWT認証が必要です：
コアワークフロー¶
ツールレビューAPIは次のリクエスト/レスポンスフローに従います：
graph TD
A[Submit Tool] --> B[Security Analysis]
B --> C{Risk Assessment}
C -->|Low Risk| D[Auto-Approve]
C -->|High Risk| E[Human Review Queue]
E --> F[Human Decision]
F --> D
D --> G[Code Signing]
G --> H[Signed Tool Ready]エンドポイント¶
レビューセッション¶
ツールをレビューに提出¶
MCPツールをセキュリティレビューと分析に提出します。
リクエストボディ：
{
"tool_name": "string",
"tool_version": "string",
"source_code": "string",
"metadata": {
"description": "string",
"author": "string",
"permissions": ["array", "of", "permissions"]
}
}
レスポンス：
レビューセッション一覧¶
オプションのフィルタリングでページ分割されたレビューセッションのリストを取得します。
クエリパラメータ：
- page (integer): ページ分割のページ番号
- limit (integer): ページあたりのアイテム数
- status (string): レビューステータスでフィルタ
- author (string): ツール作成者でフィルタ
レスポンス：
{
"sessions": [
{
"review_id": "uuid",
"tool_name": "string",
"status": "string",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T11:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 100,
"has_next": true
}
}
レビューセッション詳細取得¶
特定のレビューセッションの詳細情報を取得します。
レスポンス：
{
"review_id": "uuid",
"tool_name": "string",
"tool_version": "string",
"status": "string",
"analysis_results": {
"risk_score": 85,
"findings": ["array", "of", "security", "findings"],
"recommendations": ["array", "of", "recommendations"]
},
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T11:00:00Z"
}
セキュリティ分析¶
分析結果取得¶
特定の分析に対する詳細なセキュリティ分析結果を取得します。
レスポンス：
{
"analysis_id": "uuid",
"review_id": "uuid",
"risk_score": 85,
"analysis_type": "automated",
"findings": [
{
"severity": "high",
"category": "code_injection",
"description": "Potential code injection vulnerability detected",
"location": "line 42",
"recommendation": "Sanitize user input before execution"
}
],
"rag_insights": [
{
"knowledge_source": "security_kb",
"relevance_score": 0.95,
"insight": "Similar patterns found in known vulnerabilities"
}
],
"completed_at": "2024-01-15T10:45:00Z"
}
人間レビューワークフロー¶
レビューキュー取得¶
人間レビューが保留中のアイテムを取得します。通常、手動検査が必要な高リスクツールです。
レスポンス：
{
"pending_reviews": [
{
"review_id": "uuid",
"tool_name": "string",
"risk_score": 92,
"priority": "high",
"assigned_to": "reviewer@example.com",
"escalated_at": "2024-01-15T11:00:00Z"
}
],
"queue_stats": {
"total_pending": 5,
"high_priority": 2,
"average_wait_time": "2h 30m"
}
}
レビュー決定提出¶
ツールレビューに対する人間レビュアーの決定を提出します。
リクエストボディ：
{
"decision": "approve|reject|request_changes",
"comments": "Detailed review comments",
"conditions": ["array", "of", "approval", "conditions"],
"reviewer_id": "reviewer@example.com"
}
レスポンス：
{
"review_id": "uuid",
"decision": "approve",
"processed_at": "2024-01-15T12:00:00Z",
"next_status": "approved_for_signing"
}
ツール署名¶
署名ステータス取得¶
レビューされたツールの署名ステータスと署名情報を取得します。
レスポンス：
{
"review_id": "uuid",
"signing_status": "completed",
"signature_info": {
"algorithm": "RSA-SHA256",
"key_id": "signing-key-001",
"signature": "base64-encoded-signature",
"signed_at": "2024-01-15T12:30:00Z"
},
"certificate_chain": ["array", "of", "certificates"]
}
署名されたツールダウンロード¶
埋め込み署名と検証メタデータを含む署名されたツールパッケージをダウンロードします。
レスポンス： 署名されたツールパッケージのバイナリダウンロード。
統計・監視¶
ワークフロー統計取得¶
レビューワークフローに関する包括的な統計と指標を取得します。
レスポンス：
{
"workflow_stats": {
"total_reviews": 1250,
"approved": 1100,
"rejected": 125,
"pending": 25
},
"performance_metrics": {
"average_review_time": "45m",
"auto_approval_rate": 0.78,
"human_review_rate": 0.22
},
"security_insights": {
"common_vulnerabilities": ["sql_injection", "xss", "code_injection"],
"risk_score_distribution": {
"low": 45,
"medium": 35,
"high": 20
}
}
}
レート制限¶
ツールレビューAPIはエンドポイントタイプごとにレート制限を実装しています：
- 提出エンドポイント: 1分間に10リクエスト
- クエリエンドポイント: 1分間に100リクエスト
- ダウンロードエンドポイント: 1分間に20リクエスト
レート制限ヘッダーはすべてのレスポンスに含まれます：
エラーハンドリング¶
APIは標準的なHTTPステータスコードを使用し、詳細なエラー情報を返します：
{
"error": {
"code": "INVALID_REQUEST",
"message": "Tool source code is required",
"details": {
"field": "source_code",
"reason": "missing_required_field"
}
}
}
CLI サブコマンド¶
長時間稼働する HTTP サーフェスに加えて、symbi はワンショット操作用の CLI 専用サブコマンドをいくつか公開しています。完全なカタログは symbi --help にあります。統合およびポリシー実施に最も関連するものは以下のとおりです：
symbi schemapin¶
MCP サーバー設定に対する TOFU（Trust-On-First-Use）整合性ピン留め。SessionStart フックから呼び出されるように設計されており、オペレーターが承認しない限り、MCP サーバーの設定ハッシュがセッション間で知らないうちに変わることがないようにします。
# Verify the pinned hash for one or all MCP servers in .mcp.json
symbi schemapin verify [--mcp-server <NAME>] [--config <PATH>]
# Pin the current config hash for a server
symbi schemapin pin --mcp-server <NAME> [--config <PATH>] [--force]
# List every pinned server under ~/.symbiont/schemapin/mcp/
symbi schemapin list
# Remove a pin record
symbi schemapin unpin --mcp-server <NAME>
ピンは ~/.symbiont/schemapin/mcp/ 配下に JSON レコードとして保存されます。verify は一致すれば 0、不一致またはピンが見つからない場合は非ゼロで終了します — 事前セッションスクリプトでの使用に適しています。
symbi policy¶
ツール呼び出しイベントに対する Cedar ポリシー評価。単一のイベントを JSON として読み取り、ポリシーディレクトリに対して allow / deny を判定し、スクリプトに適した終了ステータスコードで終了します。
# Evaluate an event read from stdin
echo '{"principal":"Agent::\"dev\"", "action":"write", "resource":{...}}' \
| symbi policy evaluate --stdin --policies ./policies
# Evaluate an event read from a file
symbi policy evaluate --input event.json --policies ./policies
# Emit structured JSON only (suitable for programmatic use)
symbi policy evaluate --stdin --policies ./policies --json
デフォルトの出力は stdout への判定のみで、構造化された詳細は stderr に出力されます。--json を渡すとすべてが stdout JSON に集約されます。これはランタイムがインラインで使用しているのと同じ Cedar 決定ロジックであり、CI でのシフトレフトポリシーテストや、稼働中のランタイム外での拒否のデバッグに役立ちます。
symbi agents-md¶
現在の agents/*.symbi ファイルから AGENTS.md を再生成します（後方互換のため .dsl も認識されます）。symbi init の実行中に自動的に実行されます。エージェント定義を追加または編集した後に手動で呼び出してください。
はじめに¶
ランタイムHTTP API¶
-
symbiバイナリをビルドします（バイナリクレートではhttp-apifeatureがデフォルトで有効です）： -
ランタイムを起動します -- APIは
:8080、HTTP Inputは:8081でリッスンします：
スキャフォールドされたプロジェクトと推奨のDockerフローについては、Getting Started を参照してください。
-
サーバーが実行中であることを確認：
-
認証済みエンドポイントをテスト --
symbi upは起動時に生成されたベアラートークンを出力します（または--http.tokenで明示的に設定できます）：
ツールレビューAPI¶
- Symbiont管理者からAPI認証情報を取得
/sessionsエンドポイントを使用してツールをレビューに提出/sessions/{reviewId}経由でレビュー進捗を監視/signing/{reviewId}/downloadから署名されたツールをダウンロード
サポート¶
APIサポートと質問については： - ランタイムアーキテクチャドキュメントを確認 - セキュリティモデルドキュメントをチェック - プロジェクトのGitHubリポジトリで問題を報告
突き合わせ済み（reconciled）の呼び出しは HTTP 409 と、個別に署名された運用者の resolution を返します。ランタイムの完了結果を捏造して返すことはありません。cron の履歴には Reconciled ステータス、元のエラーと監査情報、および resolution オブジェクトが保持されます。ジョブは明示的に再開されるまで一時停止のままです。運用者による突き合わせを参照してください。