仓颉编程语言是一款面向全场景智能的新一代编程语言，主打原生智能化、天生全场景、高性能、强安全。主要应用于鸿蒙原生应用及服务应用等场景中，为开发者提供良好的编程体验。
​​
​​​

一、为什么关注Cangjie Magic？

背景：仓颉（Cangjie）是华为自主研发的通用编程语言，而 Cangjie Magic 是其首个原生Agent开发框架。它通过三大革新解决传统Agent开发的痛点：
声明式编程： 用DSL描述Agent行为，无需关注底层实现
MCP协议： 统一工具调用接口，像USB-C一样连接AI与外部服务
多Agent协作引擎： 支持管道式、主从式、自由协同三种协作模式

二、实战：打造旅行规划Agent

场景痛点：用户输入“3天上海文艺之旅”，自动生成含景点、交通、天气的完整方案。

1. Agent定义 - 角色分工

// 景点推荐Agent
@agent[model: "gpt-4o", executor: "react:3"]
class AttractionAgent {
  @prompt[pattern: RACE](
    role: "上海本地旅行专家",
    action: "推荐符合'文艺'主题的景点",
    context: "避开拥挤的网红打卡地",
    expectation: "返回包含名称、特色、门票信息的JSON"
  )
  
  @tool[description: "获取实时景点人流数据"]
  func getCrowdLevel(place: String): Int { ... }
}

// 天气查询Agent（MCP工具调用）
@agent[
  mcp: [http("https://weather-api.com")] // 接入天气服务
]
class WeatherAgent { ... }

2. 多Agent协同 - 主从架构

// 主Agent协调任务流
@agent[executor: "plan-react"]
class TravelPlanner {
  @user("城市：{city}，主题：{theme}，天数：{days}")
  ...
}

// 构建协作组：主Agent + 子Agent
let master = TravelPlanner()
let group = master <= [AttractionAgent(), WeatherAgent(), RouteAgent()]

3. 结构化输出 - 旅行计划生成

// 定义输出数据结构
@jsonable
class TravelPlan {
  @field["每日行程"]
  days: Array<{
    date: String
    attractions: Array<{ name: String, crowd: Int }>
    weather: String
  }>
}

// 获取结构化结果
let plan = group.chatGet<TravelPlan>(
  ("city", "上海"), 
  ("theme", "文艺"), 
  ("days", "3")
)

四、创新点解析

1.动态工具过滤

@agent[enableToolFilter: true] // 自动选择工具

• 当用户问“需要带伞吗？”时，自动激活WeatherAgent

2.RAG增强知识库

@agent[rag: { source: "shanghai_attractions.db" }] // 加载本地景点数据库

3.MCP协议扩展性

MCP （Model Context Protocol，模型上下文协议）定义了应用程序和 AI 模型之间交换上下文信息的方式。这使得开发者能够以一致的方式将各种数据源、工具和功能连接到 AI 模型（一个中间协议层），就像 USB-C 让不同设备能够通过相同的接口连接一样。MCP 的目标是创建一个通用标准，使 AI 应用程序的开发和集成变得更加简单和统一。


通过标准化协议接入第三方服务（如地图API、酒店预订）

附：极简部署步骤
1、安装仓颉工具链

cjc plan.cj -o travel_ai && ./travel_ai

2、启动MCP服务端（Node.js示例）

// 暴露天气查询工具
mcp.exposeTool("getWeather", (city) => fetchWeatherAPI(city))

结语：Cangjie Magic将Agent开发从“手写逻辑”推向“声明意图”时代。正如其名，它正用汉字编程的浪漫，书写国产AI基础设施的新篇章。