【仓颉 + 鸿蒙 + AI Agent】CangjieMagic框架（4）：异步Agent响应

九丘教育

已于 2025-04-20 08:37:25 修改

阅读量928

点赞数 33

分类专栏：仓颉 + 鸿蒙 + AI Agent 文章标签： harmonyos 人工智能华为

于 2025-04-07 11:26:19 首次发布

版权归九丘教育所有，严禁转载，侵权必究

本文链接：https://blog.youkuaiyun.com/margaret_lau_01/article/details/147040124

版权

仓颉 + 鸿蒙 + AI Agent 专栏收录该内容

19 篇文章

订阅专栏

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

这篇文章剖析一下 CangjieMagic 框架中的 AsyncAgentResponse。

1 类的定义与继承关系

public class AsyncAgentResponse <: Iterator<String> {
    // 类的实现...
}

首先我们看到，AsyncAgentResponse类实现了Iterator<String>接口。这个设计非常巧妙，就像我们生活中的自来水管道一样，它允许数据像水流一样一点一点地流出来，而不是等到水池装满才一次性倒出。

2 核心成员变量分析

private let chunks: Iterator<String>
private let _content = StringBuilder()
public let execInfo: Option<AgentExecutionInfo>

这个类有三个关键成员变量：

chunks: 这是一个字符串迭代器，就像一卷正在慢慢展开的画卷，每次只显示一小部分内容。
_content: 一个StringBuilder对象，用来累积所有的内容片段，就像我们记笔记时，一点一点地积累成完整的笔记本。
execInfo: 包含执行信息的可选对象，它记录了Agent执行过程的上下文信息，就像导演手中的剧本，记录着演员该做什么。

3 构造函数解析

public init(chunks: Iterator<String>) {
    this.chunks = chunks
    this.execInfo = None
}

public init(chunks: Iterator<String>, execInfo!: AgentExecutionInfo) {
    this.chunks = chunks
    this.execInfo = execInfo
}

类提供了两个构造函数，这就像餐厅提供了标准套餐和豪华套餐两种选择：

基础版：只需提供内容块迭代器，执行信息为空
高级版：同时提供内容块迭代器和执行信息

4 属性访问器分析

public prop content: String {
    get() {
        // Consume all chunks
        for (_ in this) { }
        _content.toString()
    }
}

content属性的获取器做了一件事情：它会消费迭代器中的所有内容块（通过遍历自己），然后返回完整的内容字符串。

这个过程是同步的，会阻塞直到所有内容都获取完毕，注释中也特别强调了这一点。

5 迭代器函数实现

override public func next(): Option<String> {
    if (let Some(chunk) <- this.chunks.next()) {
        _content.append(chunk)
        return chunk
    } else {
        if (let Some(info) <- this.execInfo) {
            info.dialog.addMessage(ChatMessage.assistant(_content.toString()))
        }
        return None
    }
}

next()函数是实现Iterator接口的核心，它做了两件事：