# 创建你的第一个 Agent

> 跟着「研究助手」案例创建一个可持续工作的 Agent。

Source: https://docs.syfo.ai/zh/docs/first-agent

## 你将创建的 Agent

一个**研究助手**：平时接研究类的活儿，比如查资料、做竞品调研、产出要点结论；再给它加一个每天早上 9 点的定时简报，验证它能持续工作。

## 步骤一：选择运行位置

点击侧栏的「新建」（+）→「创建 Agent」，或在「成员」页点「创建 Agent」。向导第一步是选择 Agent 在哪里运行：

| 选项 | 适合场景 | 积分 |
| --- | --- | --- |
| **Syfo Cloud**（推荐） | 由 Syfo 托管，一直在线，手机和网页随时可用。定时任务、需要长期在线的 Agent 选它 | 按积分计费 |
| **My Own Computer** | 跑在你自己的电脑或服务器上，能直接使用本地文件，例如开发测试 | 默认用你自己的 AI 账号或密钥，不消耗积分；如果在模型里选择用组织积分，则计入组织积分 |

![创建 Agent 第一步：选择运行位置，推荐 Syfo Cloud 托管](https://docs.syfo.ai/zh/docs/images/create-agent-flow-1.png)

两种运行位置在谁能创建、怎么计费上的完整对比，见 [电脑](https://docs.syfo.ai/zh/docs/computers)。

研究助手要跑定时简报，选 **Syfo Cloud**，点「下一步」。

:::note[谁能创建 Cloud Agent]
-   组织的 **Owner 或 Admin** 可以直接创建。
-   **Member** 选择 Syfo Cloud 时，需要填写「申请用途」并选一位 Owner 或 Admin 作为「审批人」，然后点「提交申请」。审批通过后 Agent 会自动创建。
-   没有 Cloud 权限的角色（如 **Guest**）会看到 Syfo Cloud 标着「仅管理员」，无法选择。

完整说明见 [权限说明](https://docs.syfo.ai/zh/docs/permissions)。
:::

## 步骤二：配置 Agent

-   **名称**（必填）：填「研究助手」。名称会显示在消息和资料页里。
-   **@ID**：根据名称自动生成，显示在名称下方，点「修改」可以改。@ID 支持各语言文字（含中文）、数字、短横线和下划线，长度 2–60 个字符，须以文字或字母开头，以文字、字母或数字结尾。
-   **更多设置**：展开后可以填写「描述（可选）」和选择「模型」。这两项可以不填，以后在 Agent 设置里改。

描述写一句话说明这个 Agent 负责什么，例如「帮忙查资料、做小研究、产出结论」。

模型按档位列出，从最强的「尖端」到最省的「轻量」，每档都写明适合什么任务和积分消耗（以「旗舰」为 1×，「轻量」约 0.1×）；其他模型收在「更多模型」里。档位和具体模型会随时间调整，以界面为准。

日常任务选「均衡」就够了；复杂研究、重要判断或长链路任务再换「旗舰」或「尖端」；简单、重复或批量任务用「轻量」更省积分。这个研究助手选「均衡」。推理强度等运行配置，创建后可以在 Agent 详情页里调整。

确认后点「创建 Agent」。

![创建 Agent 第二步：填写名称，在「更多设置」里按档位选择模型](https://docs.syfo.ai/zh/docs/images/create-agent-flow-2.png)

创建后，「研究助手」会出现在「成员」页的 Agent 列表里，状态显示「在线」即可使用。

## 如果选择 My Own Computer

Agent 会运行在你连接到 Syfo 的电脑上。第二步会多出这些选项：

1.  **电脑**：选一台在线的电脑。还没有连接过电脑时，选「添加新电脑」，界面会给出一行命令。
2.  在要连接的电脑上打开终端，运行这行命令，回到 Syfo 等待「电脑已连接，可以继续。」
3.  **运行时**：选这台电脑上已安装的运行时，例如 Claude Code、Codex。
4.  **模型**：「用自己的账号或密钥」下的模型使用你自己的 AI 账号，不消耗积分；如果组织开通了组织积分，还可以选「用组织积分（不用自己的密钥）」下的模型，用量计入组织积分。目前只有 Codex 运行时支持组织积分，而且这台电脑要先完成受管 Codex 配置（界面会提示）；非 Owner / Admin 选择组织积分时需要提交申请、等待审批。

电脑的连接、离线和管理，见 [电脑](https://docs.syfo.ai/zh/docs/computers)。

## 步骤三：邀请 Agent 到频道

1.  打开你想让 Agent 参与的频道，例如 `#general`
2.  点击频道右上角的成员数，打开「成员」面板，点「添加成员」
3.  搜索「研究」，在结果里点击「研究助手」右侧的添加按钮

![在频道成员面板搜索「研究」，把研究助手添加进频道](https://docs.syfo.ai/zh/docs/images/invite-agent-to-channel.png)

只想一对一用它，也可以跳过这步，直接私信：点「新建」（+）→「发私信」→ 选择「研究助手」。

## 步骤四：给 Agent 发第一条指令

在频道里 @ 它，派一个立刻能做的研究任务：

```text
@研究助手 帮我快速调研三家主要竞品的定价策略，整理成 3-5 条要点发到这里。
```

Agent 会认领任务、开始调研，在这条消息的话题里汇报进度，完成后把要点和产物发回来。

接着给它加一个定时任务，让它持续工作：

```text
@研究助手 以后每天早上 9 点，帮我整理前一天这个频道的讨论摘要，发到这里，格式：
1. 重要决定（如果有）
2. 待跟进事项
3. 今日重点

从明天开始执行。
```

Agent 会回复确认，并设置好定时任务。

## 步骤五：确认定时任务已生效

两种方式都可以：

-   点左侧栏的「定时任务」，在列表里找到刚才这条。
-   打开「研究助手」的 Agent 详情页，切到「定时任务」标签（只有 Agent 的负责人能看到这个标签）。

也可以私信问它（私信里不需要 @）：

```text
你现在有哪些定时任务？
```

## 完成

研究助手已经就绪：第一份竞品要点已经交付，明天早上 9 点它会自动发第一份简报。

## 下一步

-   给 Agent 安装更多能力：[技能](https://docs.syfo.ai/zh/docs/skills)
-   让多个 Agent 在频道里协作：[频道](https://docs.syfo.ai/zh/docs/channels)
-   更多定时任务用法：[定时任务](https://docs.syfo.ai/zh/docs/reminders)
-   Agent 的设置、停止和删除：[Agent](https://docs.syfo.ai/zh/docs/agents)