Symbiont 文档¶

策略治理的智能体运行时，面向生产环境。在明确的策略、身份和审计控制下执行 AI 智能体和工具。

什么是 Symbiont？¶

Symbiont 是一个 Rust 原生运行时，用于在明确的策略、身份和审计控制下执行 AI 智能体和工具。

大多数智能体框架关注编排。Symbiont 关注的是智能体在具有真实风险的环境中运行时会发生什么：不受信任的工具、敏感数据、审批边界、审计需求和可重复的执行。

工作原理¶

Symbiont 将智能体意图与执行权限分离：

智能体提议通过推理循环（Observe-Reason-Gate-Act）发起操作
运行时评估每个操作的策略、身份和信任检查
策略决定 — 允许的操作执行；拒绝的操作被阻止或转交审批
所有操作都被记录 — 每个决策的防篡改审计轨迹

模型输出永远不被视为执行权限。运行时控制实际发生的事情。

核心能力¶

能力	功能说明
策略引擎	使用 Cedar 对智能体操作、工具调用和资源访问进行细粒度授权
工具验证	执行前通过 SchemaPin 对 MCP 工具模式进行密码学验证
智能体身份	通过 AgentPin 为智能体和计划任务提供域锚定的 ES256 身份
推理循环	类型状态强制的 Observe-Reason-Gate-Act 循环，带策略门控和断路器
沙箱	三个 OSS 隔离层级的逐智能体隔离 —— Docker（第 1 层）、gVisor（第 2 层）、Firecracker microVM（第 3 层）—— 在 DSL 中按智能体选择，无任何企业版限制
审计日志	每个策略决策的防篡改日志和结构化记录
密钥管理	Vault/OpenBao 集成，AES-256-GCM 加密存储，按智能体隔离
MCP 集成	原生 Model Context Protocol 支持，带治理工具访问

附加能力：工具/技能内容的威胁扫描、cron 调度、持久智能体记忆、混合 RAG 搜索（LanceDB/Qdrant）、webhook 验证、投递路由、OTLP 遥测、HTTP 安全加固、通道适配器（Slack/Teams/Mattermost），以及 Claude Code 和 Gemini CLI 的治理插件。

快速开始¶

脚手架并运行项目（Docker，约 60 秒）¶

# 1. 创建项目。生成 symbiont.toml、agents/、policies/、
#    docker-compose.yml，以及包含新生成 SYMBIONT_MASTER_KEY 的 .env。
docker run --rm -v $(pwd):/workspace ghcr.io/thirdkeyai/symbi:latest \
  init --profile assistant --no-interact --dir /workspace

# 2. 启动运行时。自动读取 .env。
docker compose up

运行时 API 位于 http://localhost:8080，HTTP Input 位于 http://localhost:8081。

安装（不使用 Docker）¶

安装脚本（macOS / Linux）：

curl -fsSL https://symbiont.dev/install.sh | bash

Homebrew（macOS）：

brew tap thirdkeyai/tap
brew install symbi

从源代码构建：

git clone https://github.com/thirdkeyai/symbiont.git
cd symbiont
cargo build --release

预构建二进制文件也可从 GitHub Releases 获取。有关完整详情，请参阅入门指南。

您的第一个智能体¶

agent secure_analyst(input: DataSet) -> Result {
    policy access_control {
        allow: read(input) if input.verified == true
        deny: send_email without approval
        audit: all_operations
    }

    with memory = "persistent", requires = "approval" {
        result = analyze(input);
        return result;
    }
}

有关完整语法（包括 metadata、schedule、webhook 和 channel 块），请参阅 DSL 指南。

项目脚手架¶

symbi init        # 交互式项目设置 — 写入 symbiont.toml、agents/、
                  # policies/、docker-compose.yml，以及包含生成的
                  # SYMBIONT_MASTER_KEY 的 .env。使用 --dir <PATH>
                  # 指定目标目录（在容器内运行时必需）。
symbi run agent   # 运行单个智能体，无需启动完整运行时
symbi up          # 启动完整运行时，自动配置
symbi shell       # 交互式智能体编排 shell（Beta）—— 参见下文

交互式 shell（Beta）¶

symbi shell 是一个基于 ratatui 的终端 UI，用于在 LLM 辅助下编写智能体、工具和策略，编排多智能体模式（/chain、/parallel、/race、/debate），管理调度和通道，并附加到远程运行时。状态为 beta —— 命令接口和持久化格式仍可能在次要版本之间变化。请参阅 Symbi Shell 指南。

部署单个智能体（Beta）¶

shell 的 /deploy 命令会打包当前活动的智能体并将其交付到 Docker（/deploy local）、Google Cloud Run（/deploy cloudrun）或 AWS App Runner（/deploy aws）。OSS 技术栈为单智能体；多智能体拓扑通过跨实例消息传递组合。请参阅 Symbi Shell —— 部署。

架构¶

graph TB
    A[Policy Engine — Cedar] --> B[Core Runtime]
    B --> C[Reasoning Loop — ORGA]
    B --> D[DSL Parser]
    B --> E[Sandbox — Docker]
    B --> I[Audit Trail]

    subgraph "Scheduling"
        S[Cron Scheduler]
        H[Session Isolation]
        R[Delivery Router]
    end

    subgraph "Channels"
        SL[Slack]
        TM[Teams]
        MM[Mattermost]
    end

    subgraph "Knowledge"
        J[Context Manager]
        K[Vector Search]
        L[RAG Engine]
        MD[Agent Memory]
    end

    subgraph "Trust Stack"
        M[MCP Client]
        N[SchemaPin]
        O[AgentPin]
        SK[Threat Scanner]
    end

    C --> S
    S --> H
    S --> R
    R --> SL
    R --> TM
    R --> MM
    C --> J
    C --> M
    J --> K
    J --> L
    J --> MD
    M --> N
    C --> O
    C --> SK