Skip to content

colony-harness生产级 AI Agent 运行时

从 ReAct 循环到质量门禁,覆盖工具、记忆、追踪、护栏与评测的全链路基础设施。

pnpm add colony-harnessCopy
agent.ts
import { HarnessBuilder, PromptInjectionGuard } from 'colony-harness'
import { OpenAIProvider } from '@colony-harness/llm-openai'
import { ConsoleTraceExporter } from '@colony-harness/trace-console'
import { calculatorTool } from '@colony-harness/tools-builtin'

// 30 秒构建一个生产级 Agent
const harness = new HarnessBuilder()
.llm(new OpenAIProvider({ apiKey: process.env.OPENAI_API_KEY, model: 'gpt-4o' }))
.tool(calculatorTool)
.trace(new ConsoleTraceExporter())
.guard(new PromptInjectionGuard())
.build()

Why colony-harness?

模型很强大,但缺少一个可靠的生产运行时。我们补上了这一层。

生产级安全

五重护栏管线覆盖注入检测、PII 脱敏、Token 限制、敏感词和速率控制,从第一天就可以上线。

Zod 工具校验

工具注册使用 Zod Schema,输入输出自动校验,JSON Schema 自动生成给 LLM 消费,零遗漏。

全链路追踪

内置 Span / Event / Metrics 三层追踪,四种导出器覆盖终端、文件、OTel 和 Langfuse。

三层记忆

Working / Episodic / Semantic 三级记忆架构,自动上下文压缩,Token 超限不再是噩梦。

评测门禁

7 种 Scorer + Eval Gate,质量门禁自动拦截不达标版本,让发布有据可依。

多模型统一

OpenAI / Anthropic / Gemini / 兼容接口四路统一,切换 Provider 只换一行代码。

架构全景

中心化运行时,插件化生态 —— 按需组装,各司其职。

LLM Providers4 packages
⋮ ⋮ ⋮
Memory2 adapters
ColonyHarnessCore Runtime
Trace4 exporters
⋮ ⋮ ⋮
Tools8 built-in
Evaluation7 scorers
Control Plane4 packages

包生态

18 个包,按职能分组 —— 只装你需要的。

Core
colony-harness核心运行时。HarnessBuilder、AgenticLoop、ToolRegistry、MemoryManager、TraceHub、Guardrails 全部在此。pnpm add colony-harness
LLM Providers
@colony-harness/llm-openaiOpenAI Chat Completions API 适配器。支持 tool calling 与 token 追踪。pnpm add @colony-harness/llm-openai
@colony-harness/llm-anthropicAnthropic Messages API 适配器。自动分离 system 消息,映射 tool_use 格式。pnpm add @colony-harness/llm-anthropic
@colony-harness/llm-geminiGoogle Gemini generateContent API 适配器。映射角色与 functionDeclarations。pnpm add @colony-harness/llm-gemini
@colony-harness/llm-openai-compatible兼容 OpenAI 协议的通用适配器。适配国内大模型或自部署端点。pnpm add @colony-harness/llm-openai-compatible
Memory
@colony-harness/memory-sqliteSQLite 持久化记忆适配器。支持相似度搜索、按会话清理,自动建表。pnpm add @colony-harness/memory-sqlite
@colony-harness/memory-redisRedis 记忆适配器。Hash 存储条目、Sorted Set 时间排序、Pipeline 优化。pnpm add @colony-harness/memory-redis
Trace
@colony-harness/trace-console终端彩色输出追踪器。ANSI 色彩展示 TraceID、任务信息、耗时和 Span 细节。pnpm add @colony-harness/trace-console
@colony-harness/trace-fileJSONL 文件追踪器。追加写入,支持 pretty-print JSON 模式。pnpm add @colony-harness/trace-file
@colony-harness/trace-otelOpenTelemetry 桥接器。对齐 OpenInference 语义(session.id、input/output.value)。pnpm add @colony-harness/trace-otel
@colony-harness/trace-langfuseLangfuse 原生导出器。批量发送 Trace 与 Observation,支持自定义 fetch 和 tags。pnpm add @colony-harness/trace-langfuse
Tools
@colony-harness/tools-builtin8 个内置工具:http_request、read_file、write_file、run_command、search_web、calculator、json_query、template_render。pnpm add @colony-harness/tools-builtin
Eval
@colony-harness/evals评测工具包。runEvalSuite 执行器、7 种 Scorer、evaluateGate 质量门禁。pnpm add @colony-harness/evals
Control Plane
@colony-harness/controlplane-contract控制面统一端口契约。定义 TaskEnvelope、ControlPlanePort 等接口类型。
@colony-harness/controlplane-runtime运行时桥接器。连接 ColonyHarness 与 ControlPlanePort,管理任务生命周期。
@colony-harness/controlplane-mock-adapter内存 Mock 适配器。支持 dispatchTask 直接注入,用于测试场景。
@colony-harness/controlplane-sdk-adapterQueen SDK 适配器。通过 colony-bee-sdk 连接 Queen 控制面。
18
Packages
4
LLM Providers
8
Built-in Tools
7
Eval Scorers

Released under the MIT License.