适合谁
- 需要在内部部署AI代理并强调数据驻留和审计的组织。
- 希望使用Claude Code、Codex或Gemini运行代理的开发团队。
- 需要隔离、调度和可观测性的生产级代理编排。
T
62FMRS · C
Trinity是一个功能丰富的自托管AI代理编排平台。它提供广泛的MCP工具用于代理管理、调度、通信、监控和治理。适合生产环境使用，但需要Docker和自托管基础设施。MCP集成通过streamable-http提供，要求身份验证。
Trinity是一个自主AI代理平台，允许你在自己的基础设施上构建和运行专有系统。每个代理在自己的隔离Docker容器中运行，提供实时可观测性、车队调度、代理间委派和防篡改审计跟踪。支持多个运行时：Claude Code（Anthropic）、OpenAI Codex和Gemini CLI（Google）。平台包括一个Vue.js前端、FastAPI后端和一个MCP服务器（端口8080），暴露90多个工具用于外部编排。
工具能力
list_agents
列出所有代理及其状态。
get_agent
获取详细代理信息。
get_agent_info
获取代理模板元数据（能力、命令等）。
create_agent
从模板创建新代理。
deploy_local_agent
打包并部署本地代理目录。
start_agent
启动代理容器。
stop_agent
停止代理容器。
rename_agent
重命名代理。
delete_agent
删除代理。
initialize_github_sync
初始化GitHub同步。
set_agent_github_pat
设置每个代理的GitHub PAT。
chat_with_agent
向代理发送消息并获取响应（支持并行和异步模式）。
get_chat_history
检索对话历史。
get_agent_logs
查看容器日志。
fan_out
向代理分发N个并行任务并收集结果。
send_message
通过已验证的电子邮件主动发送用户消息（代理发起）。
send_group_message
主动发送群组消息。
list_channel_groups
列出频道组。
deploy_system
从YAML清单部署多代理系统。
list_systems
列出已部署系统及其代理计数。
restart_system
重启系统中的所有代理。
get_system_manifest
导出系统配置为YAML。
list_templates
列出可用模板。
inject_credentials
直接向代理注入凭据文件。
get_credential_status
检查凭据文件。
get_agent_ssh_access
生成临时SSH凭据以直接访问终端。
list_schedules
列出所有计划。
create_schedule
创建新计划。
update_schedule
更新计划。
delete_schedule
删除计划。
enable_schedule
启用计划。
disable_schedule
禁用计划。
trigger_schedule
手动触发计划。
list_executions
列出最近的执行。
poll_async_result
轮询异步结果。
get_agent_activity
获取代理活动摘要。
list_tags
列出所有代理标签。
get_tag
获取标签。
set_tag
设置标签。
add_agent_tag
为代理添加标签。
remove_agent_tag
从代理移除标签。
list_subscriptions
列出订阅。
register_subscription
注册Claude Max/Pro订阅。
assign_subscription
将订阅分配给代理。
unassign_subscription
取消分配订阅。
list_skills
列出技能。
create_skill
创建技能。
update_skill
更新技能。
delete_skill
删除技能。
assign_skill
将技能分配给代理。
get_fleet_health
获取舰队健康状态。
get_agent_health
获取代理健康详情。
trigger_health_check
触发健康检查。
configure_payments
配置Nevermined x402支付。
toggle_payment
切换支付。
view_payment_history
查看支付历史。
send_notification
从代理向平台发送结构化通知。
emit_event
发出事件。
subscribe_to_events
订阅代理事件。
list_event_subscriptions
列出事件订阅。
delete_event_subscription
删除事件订阅。
git_status
获取Git状态。
git_sync
同步Git。
git_log
获取Git日志。
git_pull
拉取Git更改。
git_sync_state
获取同步状态。
git_recovery_reset
恢复重置。
list_operator_queue
读取人机循环审批项目。
respond_to_approval
响应审批项目。
run_loop
运行有界顺序任务循环。
monitor_loop
监控循环。
stop_loop
停止循环。
publish_report
发布结构化代理报告到仪表板。
write_memory
为频道会话写入每用户记忆。
list_pipelines
检查代理定义的长运行管道。
inspect_pipeline
检查管道。
make_phone_call
发起可选呼出电话。
安装接入
- 克隆仓库: git clone https://github.com/abilityai/trinity.git && cd trinity
- 复制 .env.example 到 .env 并设置 SECRET_KEY (openssl rand -hex 32) 和 ADMIN_PASSWORD。
- 运行 ./scripts/deploy/build-base-image.sh 构建基础镜像。
- 运行 ./scripts/deploy/start.sh 启动所有服务。
- 打开 http://localhost 完成设置向导，设置管理员密码并配置API密钥。
- 在MCP客户端配置 'mcpServers' 指向 http://localhost:8080/mcp，使用 'Authorization: Bearer YOUR_API_KEY' 头。
claude_desktop_config.json
{
"mcpServers": {
"trinity": {
"type": "streamable-http",
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
选型与风险
不适合谁
- 需要零配置托管解决方案的用户（需要Docker和自托管）。
- 寻求无需Docker的轻量级代理框架的人。
- 对拥有平台管理不感兴趣的团队。
所需权限
- MCP服务器需要API密钥（Bearer token）进行身份验证。
- 代理本身在Docker容器内运行，可能需要网络访问API和外部端点。
- 平台存储凭据（加密）和Git数据。
- 管理员和用户通过角色层次结构（admin、creator、operator、user）控制访问。
风险与副作用
- 自托管需要基础设施管理，错误配置可能导致安全问题。
- 代理运行的代码可能不受信任；Docker隔离是重要的缓解措施。
- 通过Git存储凭据，加密但需要适当保护。
- Webhook可能暴露公共端点，缓解措施包括HMAC签名。
常见排障
- 确保Docker守护进程正在运行，并且你具有权限。
- 检查后端日志: docker compose logs -f backend。
- 验证 .env 中的 SECRET_KEY 和 ADMIN_PASSWORD 已设置。
- 确保端口80、8000、8080未占用。
- 测试MCP连接：curl http://localhost:8080/mcp。
使用场景
在自有基础设施上部署自主AI代理，实现治理和审计。
管理多个代理的舰队，包括调度、委派和监控。
将Claude Code编写的代理部署到生产环境。
从单个YAML清单协调多代理系统。
支持客户端
Claude Desktop完整支持
Claude Code完整支持