内容
<div align="center">
<img src="https://agenthelm.online/logo.png" width="120" alt="AgentHelm Logo" />
<h1>AgentHelm</h1>
<p><strong>自主AI代理舰队的上下文和治理平台</strong></p>
<p>
<a href="https://pypi.org/project/agenthelm-sdk"><img src="https://img.shields.io/pypi/v/agenthelm-sdk?color=orange&style=flat-square" alt="PyPI" /></a>
<a href="https://www.npmjs.com/package/agenthelm-node-sdk"><img src="https://img.shields.io/npm/v/agenthelm-node-sdk?color=orange&style=flat-square" alt="npm" /></a>
<a href="https://github.com/jayasukuv11-beep/agenthelm/blob/main/LICENSE"><img src="https://img.shields.io/github/license/jayasukuv11-beep/agenthelm?style=flat-square" alt="License" /></a>
<a href="https://agenthelm.online"><img src="https://img.shields.io/badge/status-production-success?style=flat-square" alt="Status" /></a>
</p>
</div>
---
## 🧠 项目大脑循环
AgentHelm专注于代理上下文、治理和行为。其核心是 **项目大脑循环**：
```mermaid
graph TD
A[代理启动任务] --> B[从项目大脑获取丰富上下文]
B --> C[代理执行任务]
C --> D[提出新知识/决策]
D --> E[大脑编译器验证和解决冲突]
E --> F[更新项目大脑到下一个版本]
F --> A
```
1. **获取上下文**：当代理启动时，它直接从共享的 **项目大脑** 获取版本化的、索引的上下文。
2. **执行任务**：代理在安全约束内运行，使用实时可观察性、成本控制和Telegram HITL安全措施。
3. **提出知识**：当代理学习或做出设计决策时，它提出知识更新。
4. **编译和演化**：**大脑编译器** 检查冲突、验证证据并将更改合并到项目大脑的新版本中。
5. **下一个代理迭代**：下一个代理获得更准确、更新的上下文基础。
---
## 🏗️ 关键支柱
- **🧠 项目大脑和编译器**：直接从代理执行中构建的版本化、可查询的知识仓库。强制约束并解决模式/决策冲突。
- **🔭 绝对可观察性**：实时日志流、令牌跟踪和代理活动日志。
- **🛡️ 人在环中（HITL）**：针对不可逆操作（删除、支付、转账）的单键Telegram审批。
- **📉 成本和质量安全措施**：令牌预算的硬限制、证据支持的置信度评分和自动机密剥离。
- **⏸️ 远程控制**：从仪表板动态暂停、停止或覆盖代理状态。
---
## 🚀 快速入门（v1.0.0）
### Python
```bash
pip install agenthelm-sdk
```
```python
from agenthelm import Agent
# 连接到控制平面并获取项目大脑上下文
agent = Agent(key="ahe_live_...", name="市场研究员", project="AgentHelm 平台")
# 请求与数据库模式相关的上下文
context = agent.get_context(category="database")
print("上下文条目：", context.entries)
# 向大脑编译器提出新知识
agent.propose_knowledge(
summary="将身份验证从JWT迁移到会话cookie",
decisions=["使用映射到Redis后端的会话ID"],
files_modified=["lib/auth.ts", "middleware.ts"],
confidence=95
)
```
### Node.js
```bash
npm install agenthelm-node-sdk
```
```javascript
import { Agent } from 'agenthelm-node-sdk';
const agent = new Agent({
key: 'ahe_live_...',
name: '支持机器人',
project: 'AgentHelm 平台'
});
agent.log('分析情绪...', 'info');
agent.output({ score: 0.92 }, 'sentiment_results');
```
---
## 🛰️ 模型上下文协议（MCP）服务器
AgentHelm包含一个内置的MCP服务器，允许LLM客户端（如Claude Desktop、Cursor或Windsurf）获取上下文、提交提案和查询历史。
### 运行MCP服务器
您可以通过 `npx` 直接运行服务器（请确保设置配置环境变量）：
```bash
export AGENTHELM_CONNECT_KEY="your_connect_key"
export AGENTHELM_PROJECT="your_project_id_or_agent_id"
export AGENTHELM_BASE_URL="https://agenthelm.online" # 或 http://localhost:3000 用于本地开发
npx agenthelm-mcp
```
### 暴露的工具
- **`get_context`**：获取版本化的指南、决策和模式上下文。
- **`propose_knowledge`**：提出架构更新和工程决策。
- **`get_history`**：查询历史日志、归责、显示或差异版本更改。
---
## 📲 安全桥梁（Telegram）
AgentHelm在您的服务器和手机之间架起桥梁。当代理遇到用 `@irreversible` 修饰的方法时，您会收到Telegram上的丰富警报：
> **⚠️ 请求不可逆操作**
> **代理：** `云架构师`
> **操作：** `destroy_infrastructure`
> **有效载荷：** `{"region": "us-east-1"}`
>
> [ ✅ 批准 ] [ ❌ 拒绝 ]
---
## 📊 仪表板
**工业信号橙色** 仪表板提供对整个代理舰队、项目大脑健康指标和编译器时间线的精细视图。跟踪演化、解决冲突并审计每个执行步骤。
访问 **[agenthelm.online](https://agenthelm.online)** 开始使用。
---
## 🛠️ 技术栈
- **仪表板**：Next.js、TailwindCSS（工业主题）、Supabase、Shadcn/UI。
- **SDK**：Python（twine）、Node.js（TypeScript）。
- **控制**：Telegram Bot API、Edge Functions。
## ⚖️ 许可证
MIT © [AgentHelm Team](https://agenthelm.online)
