Symbiont 文档

AI原生智能体框架，用于构建具有调度、通道适配器和密码学身份的自主、策略感知智能体——使用 Rust 构建。

立即开始在 GitHub 查看

🌐 其他语言

English

中文简体

什么是 Symbiont？

Symbiont 是一个 AI 原生智能体框架，用于构建自主、策略感知的智能体，使其与人类、其他智能体和大型语言模型安全协作。它提供完整的生产级技术栈——从声明式 DSL 和调度引擎到多平台通道适配器和密码学身份验证——全部使用 Rust 构建，以确保性能和安全性。

主要特性

🛡️ 安全优先设计：零信任架构，支持多层沙箱、策略执行和密码学审计轨迹
📋 声明式 DSL：专用语言，支持定义智能体、策略、调度和通道集成，使用 tree-sitter 解析
📅 生产级调度：基于 cron 的任务执行，支持会话隔离、投递路由、死信队列和抖动支持
💬 通道适配器：将智能体连接到 Slack、Microsoft Teams 和 Mattermost，支持 webhook 验证和身份映射
🌐 HTTP 输入模块：用于外部集成的 Webhook 服务器，支持 Bearer/JWT 身份验证、速率限制和 CORS
🔑 AgentPin 身份：通过锚定到 well-known 端点的 ES256 JWT 进行密码学智能体身份验证
🔐 密钥管理：HashiCorp Vault 集成，支持加密文件和操作系统钥匙串后端
🧠 上下文与知识：RAG 增强知识系统，支持向量搜索（LanceDB 嵌入式默认后端，Qdrant 可选）和可选的本地嵌入
🔗 MCP 集成：模型上下文协议客户端，支持 SchemaPin 密码学工具验证
⚡ 多语言 SDK：JavaScript 和 Python SDK，提供完整 API 访问，包括调度、通道和企业功能
🔄 智能体推理循环：类型状态强制的 Observe-Reason-Gate-Act（ORGA）循环，支持策略门控、断路器、持久日志和知识桥接
🧪 高级推理（orga-adaptive）：工具配置文件过滤、卡住循环检测、确定性上下文预获取和目录范围约定
📜 Cedar 策略引擎：正式授权语言集成，提供细粒度访问控制
🏗️ 高性能：面向生产工作负载优化的 Rust 原生运行时，全程异步执行

快速开始

快速安装

# 克隆仓库
git clone https://github.com/thirdkeyai/symbiont.git
cd symbiont

# 构建统一的 symbi 容器
docker build -t symbi:latest .

# 或使用预构建的容器
docker pull ghcr.io/thirdkeyai/symbi:latest

# 测试系统
cargo test

# 测试统一的 CLI
docker run --rm symbi:latest --version
docker run --rm -v $(pwd):/workspace symbi:latest dsl parse --help
docker run --rm symbi:latest mcp --help

您的第一个智能体

metadata {
    version = "1.0.0"
    author = "developer"
    description = "Simple analysis agent"
}

agent analyze_data(input: DataSet) -> Result {
    capabilities = ["data_analysis"]

    policy secure_analysis {
        allow: read(input) if input.anonymized == true
        deny: store(input) if input.contains_pii == true
        audit: all_operations with signature
    }

    with memory = "ephemeral", privacy = "high" {
        if (validate_input(input)) {
            result = process_data(input);
            audit_log("analysis_completed", result.metadata);
            return result;
        } else {
            return reject("Invalid input data");
        }
    }
}

架构概览

graph TB
    A[治理与策略层] --> B[核心 Rust 引擎]
    B --> C[智能体框架]
    B --> D[Tree-sitter DSL 引擎]
    B --> E[多层沙箱]
    E --> F[Docker - 低风险]
    E --> G[gVisor - 中/高风险]
    B --> I[密码学审计跟踪]

    subgraph "调度与执行"
        S[Cron 调度器]
        H[会话隔离]
        R[投递路由器]
    end

    subgraph "通道适配器"
        SL[Slack]
        TM[Teams]
        MM[Mattermost]
    end

    subgraph "上下文与知识"
        J[上下文管理器]
        K[向量数据库]
        L[RAG 引擎]
        MD[Markdown 记忆]
    end

    subgraph "安全集成"
        M[MCP 客户端]
        N[SchemaPin 验证]
        O[策略引擎]
        P[AgentPin 身份]
        SK[技能扫描器]
    end

    subgraph "可观测性"
        MET[指标收集器]
        FE[文件导出器]
        OT[OTLP 导出器]
    end

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