Cangjie Magic 技术文档

【免费下载链接】CangjieMagic 基于仓颉编程语言构建的 LLM Agent DSL，其主要特点包括：声明式 DSL、支持 MCP 协议，支持任务智能规划等。 项目地址: https://gitcode.com/Cangjie-TPC/CangjieMagic

1. 安装指南

系统要求

• 操作系统：支持 Windows/Linux/macOS
• 运行环境：JDK 11 或更高版本
• 开发工具：推荐使用 IntelliJ IDEA 或 VS Code

安装步骤

1. 克隆项目仓库到本地：

   git clone https://gitcode.com/Cangjie-TPC/CangjieMagic.git
   

2. 进入项目目录：

   cd CangjieMagic
   

3. 构建项目：

   ./gradlew build
   

4. 验证安装：

   cjpm --version
   

2. 项目使用说明

快速开始

创建一个简单的翻译程序：

import magic.dsl.*
import magic.prelude.*

@ai[model: "deepseek:deepseek-chat"]
foreign func translate(text: String, targetLang: String): String

main() {
  let msg = translate("你好，Cangjie Magic!", "en")
  println(msg)
}

运行示例程序

项目提供了多个示例程序，可通过以下命令运行：

cjpm run --name magic.examples.quick_start

主要功能

• 集成大语言模型能力
• 支持自定义Agent开发
• 提供丰富的DSL语法
• 支持工具集定义(@toolset)

3. 项目API使用文档

核心API

@ai 注解

用于声明AI函数：

@ai[model: "模型名称"]
foreign func 函数名(参数): 返回类型

@agent 注解

定义Agent行为：

@agent[name: "agent名称"]
class MyAgent {
  // Agent实现
}

@tool 注解

定义工具类：

@tool[name: "工具名称", compactable: true]
class MyTool {
  // 工具实现
}

常用模块

• magic.dsl：核心DSL语法
• magic.prelude：标准库
• magic.agent：Agent开发支持

4. 项目安装方式

方式一：源码安装

1. 下载项目源码
2. 执行构建命令
3. 配置环境变量

方式二：包管理器安装

curl -sSL https://install.cangjie.org | bash

方式三：Docker方式

docker pull cangjie/magic:latest
docker run -it cangjie/magic

开发环境配置

1. 安装IDE插件
2. 配置项目SDK
3. 导入项目依赖

常见问题解决

• 构建失败：检查JDK版本
• 运行错误：验证环境变量配置
• API调用异常：查看模型连接状态

【免费下载链接】CangjieMagic 基于仓颉编程语言构建的 LLM Agent DSL，其主要特点包括：声明式 DSL、支持 MCP 协议，支持任务智能规划等。 项目地址: https://gitcode.com/Cangjie-TPC/CangjieMagic