Magic（麦吉）：开源AI生产力平台，助力企业高效构建智能应用

Magic是全球首款开源一站式AI生产力平台，旨在帮助企业和个人通过AI技术实现高效工作。它集成了多个模块，包括通用AI代理、AI工作流编排和企业即时通讯工具。Magic采用开源理念，代码公开在GitHub，任何人都可以免费获取和定制。平台适合职场人士、创业者和企业管理者，通过智能工具提升工作效率，助力企业快速部署AI应用。Magic支持多种大型语言模型，操作简单，功能强大，适用于各种复杂任务场景。

功能列表

• 超级Magic（Super Magic）：通用AI代理，支持复杂任务处理，如自动化数据分析、内容生成等。
• Magic Flow：可视化AI工作流编排工具，允许用户设计和执行自动化工作流程。
• Magic IM：企业级即时通讯系统，集成AI代理，支持团队协作和智能对话。
• Teamshare OS（即将推出）：企业级在线协作办公系统，提供文档管理和团队协同功能。
• 支持多种大型语言模型：兼容OpenAI格式的模型，允许用户灵活配置AI能力。
• 开源代码支持：通过GitHub提供完整代码，支持开发者贡献和定制开发。

使用帮助

安装流程

Magic的安装过程简单，适合有基本技术背景的用户。以下是详细的安装步骤，基于官方GitHub文档：

1. 克隆代码库
   在终端运行以下命令，将Magic代码克隆到本地：

   git clone https://github.com/dtyq/magic.git
   cd magic
   

   这会下载Magic的完整代码库到你的本地设备。

2. 配置环境变量
   Magic需要配置至少一个支持OpenAI格式的大型语言模型（如ChatGPT或类似模型）。复制示例配置文件：

   cp .env.example .env
   cp config/.env_super_magic.example .env_super_magic
   

   打开.env和.env_super_magic文件，填入你的语言模型API密钥和其他必要参数。确保至少配置一项语言模型，否则Magic无法正常运行。

3. 启动服务
   • 前台启动：运行./bin/magic.sh start，服务会在前台运行，适合调试。
   • 后台启动：运行./bin/magic.sh daemon，服务在后台运行，适合生产环境。
   • 检查状态：运行./bin/magic.sh status，查看服务是否正常运行。
   • 查看日志：运行./bin/magic.sh logs，检查运行日志以排查问题。
4. 访问RabbitMQ管理界面
   Magic使用RabbitMQ管理任务队列。访问http://localhost:15672，使用默认用户名admin和密码magic123456登录，查看任务状态。
5. 企业功能配置
   如果你是企业用户，可以联系Magic团队（邮箱：dev@dtyq.com）获取更多管理功能支持，如高级权限控制或定制化部署。

功能操作指南

超级Magic（Super Magic）

超级Magic是Magic平台的核心AI代理，适合处理复杂任务。用户可以通过文本输入或API调用与AI交互。例如：

• 任务自动化：输入“分析上月销售数据并生成报告”，AI会自动处理数据并输出结构化报告。
• 内容生成：输入“为新产品撰写100字宣传文案”，AI会快速生成符合要求的文案。
• 操作流程：
  1. 在Magic平台登录，进入超级Magic模块。
  2. 在输入框中描述任务，如“整理Excel表格中的数据并提取关键指标”。
  3. 设置输出格式（文本、表格或JSON）。
  4. 点击“执行”，AI会在数秒内返回结果。
  5. 可通过API调用实现批量任务处理，适合企业级应用。

Magic Flow

Magic Flow是一个可视化工作流编排工具，适合需要自动化重复任务的用户。用户可以通过拖拽界面设计工作流程。例如：

• 创建工作流：
  1. 登录Magic平台，进入Magic Flow模块。
  2. 点击“新建工作流”，选择触发条件（如“收到新邮件”）。
  3. 添加动作节点，如“提取邮件内容”或“将数据存入数据库”。
  4. 连接节点，形成完整流程。
  5. 保存并运行，系统会自动执行工作流。
• 示例场景：设置一个工作流，当收到客户邮件时，自动提取订单信息并更新CRM系统。

Magic IM

Magic IM是企业级的即时通讯工具，集成了AI代理功能。团队成员可以通过它进行实时沟通，并调用AI完成任务。例如：

• 智能对话：在聊天窗口输入“@Magic 总结会议记录”，AI会自动生成会议摘要。
• 团队协作：支持创建群组、分享文件和分配任务。
• 操作流程：
  1. 登录Magic平台，进入Magic IM模块。
  2. 创建团队群组，邀请成员加入。
  3. 在对话框中使用@Magic调用AI，输入任务指令。
  4. 查看AI返回的结果，或直接分享给团队成员。

开源贡献

Magic鼓励开发者参与开源社区。用户可以：

• 访问https://github.com/dtyq/magic，查看贡献指南。
• 提交代码、报告问题或提出新功能建议。
• 如果发现安全漏洞，可发送邮件至dev@dtyq.com，团队会及时处理。

注意事项

• 环境要求：Magic需要在Linux或类Unix系统上运行，推荐使用Ubuntu 20.04或更高版本。
• 网络要求：确保设备连接稳定网络，部分功能需要访问外部API。
• 文档支持：详细文档可访问https://docs.letsmagic.cn/en，包含API说明和高级配置指南。

应用场景

1. 中小企业自动化
   中小型企业使用Magic Flow自动化日常任务，如处理客户订单、生成销售报告，节省人工成本。
2. 团队协作与沟通
   远程团队通过Magic IM进行实时沟通，结合AI代理快速完成文档整理或会议记录，提升协作效率。
3. 开发者定制AI应用
   开发者利用Magic的开源代码，定制专属AI应用，如为电商平台开发智能客服系统。
4. 数据分析与报告
   数据分析师使用超级Magic处理复杂数据集，自动生成可视化图表，缩短分析时间。

QA

1. Magic是否免费？
   Magic是开源平台，个人和开发者可以免费使用。企业用户可联系团队获取付费的高级功能支持。
2. 如何配置大型语言模型？
   在.env和.env_super_magic文件中填入支持OpenAI格式的模型API密钥，保存后重启服务即可。
3. Magic支持哪些操作系统？
   目前主要支持Linux和类Unix系统，推荐Ubuntu 20.04以上版本，暂不支持Windows直接部署。
4. 如何参与开源贡献？
   访问https://github.com/dtyq/magic，阅读贡献指南，提交代码或问题反馈。