CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。
这篇文章剖析一下 CangjieMagic 框架中的 AgentRequest 和 AgentResponse。
1 agent_request.cj 解析
首先,我们来看 agent_request.cj 文件,这个文件定义了发送给 Agent 的请求格式。
package magic.core.agent
import magic.core.message.{Dialog, ChatMessage}
public struct AgentRequest {
public let question: String // 用户当前的问题
public let dialog: Option<Dialog> // 用户与agent之间的历史对话记录
public let verbose: Bool // 是否输出详细的执行信息
public init(question: String, dialog!: Option<Dialog> = None, verbose!: Bool = false) {
this.question = question
this.dialog = dialog
this.verbose = verbose
}
}
1.1 关键组成部分:
-
question 成员变量:
这就像我们平时向餐厅服务员提问"有什么推荐菜品?"一样,是用户当前向 Agent 提出的具体问题。 -
dialog 成员变量:
这相当于你和服务员之前已经聊过的内容记录。比如你可能已经说过你喜欢辣的食物,不吃海鲜等信息。通过保存这些历史对话,Agent 可以理解上下文,提供更连贯的响应。注意这是一个Option<Dialog>类型,意味着可以为空(首次对话时)。 -
verbose 成员变量:
这就像是我们在点餐时,可以选择看厨师如何烹饪食物的详细过程。设置为true时,Agent 会输出更多内部执行的细节信息,对调试和开发很有帮助。
1.2 实际应用场景:
想象一个智能客服系统,用户问:“我的订单什么时候到货?”。此时:
question就是这个问题本身dialog可能包含用户之前提供的订单号和地址信息verbose在生产环境通常设为 false,在开发测试时设为 true
2 agent_response.cj 解析
接下来,我们来看 agent_response.cj 文件,它定义了 Agent 返回的响应格式。
package magic.core.agent
import magic.core.message.Dialog
public struct AgentResponse {
public let content: String // 执行结果
public let execInfo: Option<AgentExecutionInfo> // 执行过程中的内部信息
public init(content: String) {
this.content = content
this.execInfo = None
}
public init(content: String, execInfo!: AgentExecutionInfo) {
this.content = content
this.execInfo = execInfo
}
}
2.1 关键组成部分:
-
content 成员变量:
这就像服务员给你的最终答案,比如"您的红烧肉套餐15分钟后上桌"。它是 Agent 处理请求后给用户的直接响应内容。 -
execInfo 成员变量:
这相当于厨师的烹饪笔记,记录了从接单到出菜的全过程。它包含 Agent 执行过程中产生的内部信息,例如思考过程、检索到的参考资料等。这是一个Option<AgentExecutionInfo>类型,表示可以为空。
2.2 实际应用场景:
继续上面的例子,当用户问"我的订单什么时候到货?"时:
content可能是"您的订单#12345预计明天下午3点送达"execInfo可能包含系统如何查询订单系统、物流系统的详细过程,以及 Agent 内部的推理过程
3 架构设计的亮点与思考
请看下面的系统交互图:
975



被折叠的 条评论
为什么被折叠?



