第二章：ForgeAgent Core

Chapter 2: ForgeAgent Core

---

从方向盘到大脑：从命令行到核心逻辑

在上一章CLI接口，我们已经通过命令行创建并启动了代理。但就像汽车需要发动机才能真正行驶一样，AI代理的核心逻辑由ForgeAgent Core这个“智能大脑”驱动。本章将揭开这个大脑的运作原理！

---

核心使命：让AI代理“思考”和“行动”

想象你正在指挥一位助手完成任务：“帮我整理今天的工作安排，并预订下午3点的会议室。”
ForgeAgent Core就像这位助手的大脑，负责：

1. 理解指令：分析“整理工作安排”和“预订会议室”的具体要求
2. 分解任务：拆分成“查看日程”、“查找可用会议室”、“发送预订请求”等步骤
3. 执行操作：调用日历工具、会议室查询API等外部服务
4. 记忆信息：记住已预订的会议室名称，避免重复操作

---

关键组件拆解：大脑的组成部分

ForgeAgent Core由以下模块协同工作（用日常例子类比）：

1. 逻辑管理器（The Thinker）

作用：像大脑皮层，决定下一步该做什么
示例：
当收到“预订会议室”指令时，它会思考：

• 是否需要先确认时间是否冲突？
• 应该调用哪个API？

2. 工具集成器（The Toolbelt）

作用：像工具箱，存放各种技能
示例：
包含：

# 工具列表
tools = [CalendarAPI(),   # 日历工具EmailSender(),   # 邮件发送WebSearch()      # 网络搜索
]

3. 记忆系统（The Memory）

作用：像笔记本，记录重要信息
示例：
记录：

{"last_meeting_room": "会议室B","urgent_tasks": ["项目汇报"]
}

4. 服务协调器（The Connector）

作用：像协调员，连接外部服务
示例：
调用API时自动处理：

• API密钥验证
• 请求格式转换
• 错误重试机制

---

实战：让代理执行简单任务

场景：代理自动发送邮件提醒

步骤1：定义代理逻辑

from forge.agent import ForgeAgentclass ReminderAgent(ForgeAgent):def execute(self):# 1. 检查日程events = self.calendar_api.get_events("今天")# 2. 准备提醒内容message = f"今日待办：{', '.join(events)}"# 3. 发送邮件self.email_sender.send("提醒", message)

步骤2：启动代理

./run agent start ReminderAgent

预期输出：

📩 邮件已发送至 [e-mail]：
"今日待办：项目汇报、客户会议"

---

内部运作：大脑如何思考？

以发送邮件任务为例，执行流程如下：

---

代码探秘：核心初始化过程

在app.py中看到关键初始化代码：

# 初始化核心组件
database = AgentDB(...)      # 记忆存储
workspace = get_storage(...) # 文件操作接口
agent = ForgeAgent(database, workspace) # 绑定工具
agent.add_tools([CalendarAPI(), EmailSender()])# 创建服务应用
app = agent.get_agent_app()

代码解读：

1. AgentDB：负责存储代理的记忆数据
2. get_storage：连接文件系统（后续章节详解）
3. add_tools：像给工具箱装入不同工具

---

总结与展望

通过本章，你已掌握：
✅ 了解ForgeAgent Core的核心功能和组成部分
✅ 看到代理如何通过逻辑、工具和记忆协作完成任务

下一章我们将深入代理的“记忆仓库”——文件存储后端，学习代理如何安全地保存和检索文件数据！

---