第一次使用前准备

第一次使用 MagicAI 时，不建议直接从复杂任务开始。请先用本页这份 MagicAI 专属清单完成 6 个检查，再进入快速开始。

先确认你要使用哪类能力

MagicAI 是多智能体 / 数字员工产品，并扩展了专业技能、创作和工作流自动化（RPA）。不同任务对应的检查重点不一样。

目标	使用模块	使用前重点检查
让数字员工分析代码、拆解需求、回答问题	AI 智能团队 / Agent Team	账号权限、上下文材料、知识库
复用业务查询、通知、报告等动作	专业技能	输入输出定义、连接凭据、调用权限
生成图片或视频	创作	提示词、模板、生成额度或权限
调接口、处理数据、定时同步	工作流自动化（RPA）	输入输出、连接凭据、运行日志
操作网页、手机或桌面软件	工作流自动化（RPA）	执行环境、系统权限、元素定位
让数字员工使用团队资料	知识库	文档质量、解析状态、测试问题

如果你不确定任务属于哪类，请先阅读快速开始。

检查 1：账号和工作空间

请确认：

当前账号已开通 MagicAI 使用权限。
已选择正确的团队、租户或工作空间（企业账号通常会有选择项）。
左侧导航能看到你需要的模块。
如果要创建或发布工作流、技能、知识库，账号需要有创建、编辑、发布权限。
如果要配置连接或凭据，账号需要有对应管理权限。

如果只是使用别人发布的能力，通常只需要运行权限；要搭建任务则需要编辑和调试权限。

没看到某个模块？通常是权限或工作空间问题，先核对账号和租户，再联系管理员。

检查 2：客户端环境

MagicAI 桌面端通常会自带客户端设置或环境准备页面，第一次使用前请进入查看：

客户端版本是否最新，是否提示需要更新。
客户端日志、缓存、模型服务是否正常。
数据目录是否有读写权限。
如果出现“环境异常 / 初始化失败”，应优先解决环境问题，不要绕过。

检查 3：工作流引擎已就绪（仅工作流自动化用户必看）

MagicAI 桌面端内置了一套工作流引擎，用来执行工作流自动化（RPA）。它在客户端启动时会自动准备好，你不需要单独安装或启动。

第一次使用工作流自动化（RPA）前，请确认：

客户端已经启动并完成初始化，没有“环境异常 / 初始化失败”提示。
客户端设置或环境准备页面里，与工作流相关的状态显示正常。
操作系统防火墙没有拦截 MagicAI。

如果工作流在运行时提示“引擎不可用 / 无法连接到本地引擎”：

重新启动 MagicAI 客户端。
检查最近是否安装过抢占本地端口的工具（VPN、代理、安全软件等），必要时关闭再试。
仍然失败，请阅读常见问题与排障中的“客户端启动 / 环境异常”一节。

检查 4：操作系统权限（仅桌面 / 移动 RPA 用户必看）

如果你只用 AI 智能团队 / Agent Team 和创作，可以跳过本节。

如果要做 RPA、桌面操作或屏幕录制，操作系统会要求额外权限。第一次启动时给一次权限就行，不要每次都临时开。

macOS 必备权限

打开 系统设置 → 隐私与安全性，分别给 MagicAI 勾选：

辅助功能：用于点击、键盘控制、桌面 RPA。
屏幕录制：用于截图、OCR、元素识别。
输入监控：用于全局快捷键、按键模拟。
完全磁盘访问（按需）：当 RPA 需要读取受限目录时。

Windows 必备权限

第一次启动 MagicAI 时不要拒绝防火墙提示。
杀毒软件或终端管理软件请放行 MagicAI 主程序和本地 RPA 引擎。
操作浏览器时，避免另一个版本的 Chrome 同时连接同一调试端口。
高 DPI 显示器下若坐标偏移，可在客户端设置中开启 DPI 适配。

【醒目图片占位 | first-use-windows-permissions】
请放置 Windows 防火墙提示弹窗截图与杀毒软件信任配置截图。

权限不到位时常见症状：

RPA 无法点击 / 无法输入。
截图全黑或缺失部分窗口。
元素捕获失败、坐标错位。
弹窗被前置导致脚本卡住。

遇到这类问题，先检查权限，不要反复修改 RPA 节点参数。

检查 5：外部系统、连接和凭据

如果任务需要访问外部系统，请提前准备：

账号是否可登录、是否需要扫码 / 二次验证。
API Key、Webhook、Token 是否已配置在连接中。
目标系统是否允许自动化访问，是否有 IP 白名单。
是否有测试环境可以先验证。
是否会触发风控（频次、登录次数、地点切换）。

不要把密码、Token、Cookie 直接写在节点说明、提示词、知识库或日志中。统一通过连接外部系统管理。

检查 6：任务边界（最重要）

第一次使用建议从低风险任务开始，例如：

让 AI 智能团队 / Agent Team 帮你拆解一个工作流程。
让数字员工总结一段说明文档或日志。
用创作生成一张测试图片。
用工作流自动化（RPA）打开公开网页并读取标题。
创建一条只调用测试接口的工作流。

不建议第一次就自动化这些任务：

涉及支付、审批、提交、删除、发货等不可轻易回滚的动作。
依赖验证码、频繁登录或风控敏感的网站。
一次性跨多个系统、多个账号、多个页面的长流程。
直接面向生产数据库的批量修改。

如果某个任务必须做，但风险高，先在 AI 智能团队 / Agent Team 里让数字员工帮你拆解风险与回滚方案，再决定是否搭建工作流。

第一次成功的标准

完成本页后，你应该能做到：

正常登录 MagicAI，并选择正确工作空间。
客户端环境无明显异常提示。
本地 RPA 引擎可用（如果要用工作流 / RPA）。
macOS / Windows 上需要的权限已经一次性给好。
知道当前任务应该用 AI 智能团队 / Agent Team、专业技能、创作还是工作流自动化。

如果以上条件还没满足，请先解决环境，再进入快速开始。

卡住了？

你遇到的情况	处理方式
客户端环境一直异常	阅读常见问题与排障
工作流提示“引擎不可用 / 无法连接到本地引擎”	重启客户端、检查代理与安全软件，必要时阅读常见问题与排障
截图、点击、输入异常	重新检查 macOS / Windows 系统权限
不确定该用哪个模块	阅读产品能力总览
找不到入口	阅读产品界面导览