【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(3):Agent请求和响应

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 关键组成部分:

  1. question 成员变量:
    这就像我们平时向餐厅服务员提问"有什么推荐菜品?"一样,是用户当前向 Agent 提出的具体问题。

  2. dialog 成员变量:
    这相当于你和服务员之前已经聊过的内容记录。比如你可能已经说过你喜欢辣的食物,不吃海鲜等信息。通过保存这些历史对话,Agent 可以理解上下文,提供更连贯的响应。注意这是一个 Option<Dialog> 类型,意味着可以为空(首次对话时)。

  3. 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 关键组成部分:

  1. content 成员变量:
    这就像服务员给你的最终答案,比如"您的红烧肉套餐15分钟后上桌"。它是 Agent 处理请求后给用户的直接响应内容。

  2. execInfo 成员变量:
    这相当于厨师的烹饪笔记,记录了从接单到出菜的全过程。它包含 Agent 执行过程中产生的内部信息,例如思考过程、检索到的参考资料等。这是一个 Option<AgentExecutionInfo> 类型,表示可以为空。

2.2 实际应用场景:

继续上面的例子,当用户问"我的订单什么时候到货?"时:

  • content 可能是"您的订单#12345预计明天下午3点送达"
  • execInfo 可能包含系统如何查询订单系统、物流系统的详细过程,以及 Agent 内部的推理过程

3 架构设计的亮点与思考

请看下面的系统交互图:

相关推荐

【华为仓颉编程语言】标识符

今天我们要学习仓颉中一个非常基础但又极其重要的概念——标识符。标识符就是我们给程序元素起的"名字",比如变量名、函数名、类名等。

九丘教育官方博客 975

【华为仓颉编程语言】运行第一个仓颉程序

上节课我们成功安装了仓颉工具链,今天让我们一起编写并运行第一个仓颉程序。相信很多同学都还记得学习第一门编程语言时写的"Hello World"程序,那种看到程序成功运行的激动心情。今天,我们就要在仓颉语言中重现这个经典时刻!

九丘教育官方博客 1792

【华为仓颉编程语言】安装仓颉工具链

俗话说"工欲善其事,必先利其器"。今天这节课,我们就来学习如何安装仓颉的开发工具链。仓颉不仅仅提供了一个编译器,而是提供了一整套完整的开发工具链。接下来,让我们一起看看仓颉为我们准备了哪些工具。

九丘教育官方博客 1724

【华为仓颉编程语言】初识仓颉语言

今天这节课,我们将一起揭开仓颉编程语言的神秘面纱。可能有同学会问:"老师,现在编程语言已经这么多了,为什么还要学习仓颉?" 这个问题问得好!接下来,我会带大家深入了解仓颉语言的十大核心特性,相信学完之后,你就会明白仓颉为什么值得我们关注和学习。

九丘教育官方博客 1134

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(19):knowledgeExtract

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 knowledgeExtract。

九丘教育官方博客 1065

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(18):AgentExecutorManager

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 AgentExecutorManager。

九丘教育官方博客 965

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(17):PlanReactExecutor

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 PlanReactExecutor。

九丘教育官方博客 3353

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(16):ReactExecutor

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 ReactExecutor。

九丘教育官方博客 2432

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(15):NaiveExecutor

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 NaiveExecutor。

九丘教育官方博客 2137

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(14):ToolSelectAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 ToolSelectAgent。

九丘教育官方博客 945

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(13):ToolAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 ToolAgent。

九丘教育官方博客 1024

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(12):ConversationAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 ConversationAgent。

九丘教育官方博客 1133

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(11):HumanAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 HumanAgent。

九丘教育官方博客 1139

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(10):DispatchAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 DispatchAgent。

九丘教育官方博客 1154

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(9):AgentProxy

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 AgentProxy。

九丘教育官方博客 1209

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(8):BaseAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 BaseAgent。

九丘教育官方博客 1271

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(7):AbsAgent

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 AbsAgent。

九丘教育官方博客 1191

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(6):拦截器

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 Interceptor。

九丘教育官方博客 1335

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(5):Agent执行信息

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 AgentExecutionInfo。

九丘教育官方博客 1124

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(4):异步Agent响应

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析一下 CangjieMagic 框架中的 AsyncAgentResponse。

九丘教育官方博客 1235

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(2):Agent接口

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。这篇文章剖析剖析一下 CangjieMagic 框架中的 Agent 接口设计。

九丘教育官方博客 933

【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(1):框架简介

CangjieMagic框架:使用华为仓颉编程语言编写,专门用于开发AI Agent,支持鸿蒙、Windows、macOS、Linux等系统。

九丘教育官方博客 1118
上一篇: 【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(2):Agent接口
下一篇: 【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架(4):异步Agent响应
九丘教育
九丘教育 九丘教育官方账号 九丘教育官方账号
博客等级 码龄4年 369粉丝 23原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址