以 pip 客户端 SDK 形式复用代理工厂、工具与技能，经 HTTP 接入运行时服务

方案简介

除了 Docker 全栈自托管，Decepticon 还提供 pip 库形态：把代理当作可编程构件嵌入你自己的产品、研究集成或自定义编排器。decepticon 包是一个客户端 SDK，随包分发代理工厂（agent factories）、中间件、工具（tools）与技能（skills），而 LLM 调用和沙箱执行通过 HTTP 路由到运行时服务（由 DECEPTICON_LLM__PROXY_URL 与 SANDBOX_URL 指定）。这意味着库本身轻量，但真正运行代理仍需要 LiteLLM 代理、沙箱等运行时服务——可以直接用官方 Docker 栈，也可以把 URL 指向你自己的等价实现。适合想在 Decepticon 之上构建产品的开发者。

实施步骤

1. 安装 SDK

bash
pip install decepticon # core SDK
pip install "decepticon[neo4j]" # + the knowledge-graph attack-chain tools

核心 SDK 提供代理工厂、中间件、工具与技能；如需知识图谱式攻击链工具，加装 neo4j extra。

2. 接入运行时服务

通过环境变量 DECEPTICON_LLM__PROXY_URL 和 SANDBOX_URL 将 LLM 调用与沙箱执行路由到运行时服务。可用官方 Docker 栈，或指向你自己的等价服务。

使用与配置要点

• SDK 提供 factory override surface（工厂覆写接口）
• 支持声明式 PluginBundle 插件扩展
• 内置 safety gate（安全门）机制
• 详细用法见 docs/library-usage.md

优缺点

• ✓ 支持自定义编排器与产品集成
• ✓ 可选装知识图谱工具
• ✕ 仍需运行时服务支撑
• ✕ 需自行配置服务地址

出处

本方案挖掘自开源项目 BitterSecurity/Decepticon，方案内容与实施命令均来自其 README 原文。