入门指南
本页内容
从首次访问到第一次对话只需几分钟的工作：选择代理的运行位置，从 AI Agent 模块中添加它，然后打个招呼。本页面将介绍整个流程，最简单的步骤放在前面。
设置检查清单
在进行过程中勾选项目 —— 你的进度会保存在此浏览器中，并且你可以打印该清单以便在现场携带。
欢迎屏幕
首次在没有任何 agent 的设施中打开 AI Agent 模块时，您将看到 Welcome to AI Agent。它会逐项列出仍需完成的步骤 — 例如，如果尚未设置 Model Router，则会显示 Enable Model Router 和 Top up your balance — 并在最后引导您添加第一个 agent。
图 1：尚无 agent 的设施中的欢迎屏幕
点击 Add Agent 开始。点击 Read the documentation 可跳转至本文档，点击 Skip setup for now 则会隐藏此屏幕，直到您准备就绪。如果您尚未拥有硬件，点击 Order hardware 将打开订购页面。
步骤 1 — 选择 agent 的运行位置
点击欢迎屏幕上的 Add Agent，或者在拥有 agent 后从 agent 切换器的底部点击，即可打开 Add Agent 对话框："Where should this agent run? You can add more of either kind later."
图 2：Agent 切换器 — 在不同的 agent 之间切换，或选择底部的 Add Agent
图 3：选择 Physical Agent 或 Cloud Agent
| 选项 | 说明 | 选择时机 |
|---|---|---|
| Physical Agent | "Pair an on-site device with a serial number or QR code." Agent 运行在您现场的 AI Agent Processor 上 | 您希望将 agent 及其数据保存在您物理控制的硬件上，或者您需要本地网络上最快的连接 |
| Cloud Agent | "Launch a Cloud Agent Instance in a region you choose. No pairing." Performance Hub 会为您运行 agent | 您暂时没有硬件、需要通过一个 agent 运行多个站点，或者希望在特定地区部署 agent |
这两种类型具有相同的聊天、Memory、技能、备份、预算和访问控制功能，您还可以在同一设施中混合运行它们。
步骤 2 — 添加您的 agent
添加 Physical Agent
请先连接设备并上电：
- 将设备放置在通风且安全的位置（放置指南）。
- 如果可能，请在通电前 连接网线。如果您必须使用 Wi‑Fi，请先通电，然后按照屏幕提示加入 agent 的设置 Wi‑Fi 网络，并根据设置页面输入您的 Wi‑Fi 详细信息。
- 连接电源。设备将在几分钟内启动并上线。如果您连接了 HDMI 显示屏，它将显示设备的网络状态以及正在等待被添加到设施中的提示。
然后进行配对。 最快的方法是：使用手机扫描设备上的配对二维码贴纸，这将打开已自动填入序列号的配对对话框。或者，在 Add Agent 对话框中选择 Physical Agent 以打开 Add Physical Agent。
对话框会提醒您："Make sure the AI Agent Processor is powered on and connected to your network first." 它包含三个字段 — 设备的序列号或设备 ID（旁边带有 Scan QR code 按钮）、Device name 以及 Location — 下方还有一个折叠的 Advanced settings 部分。请填写以下内容：
| 字段 | 说明 |
|---|---|
| 序列号或设备 ID | 第一个字段。请输入位于设备底部或背部的二维码贴纸或标签上的序列号，或者点击 Scan QR code 使用相机扫描贴纸 |
| Device name | 所有人将在智能代理切换器中看到的名称，例如 Meeting Room Agent 或 Café Counter。请选择一个易于辨认的名称 |
| Location | 设备所在的物理位置，例如 Level 3 meeting rooms 或 Comms cabinet。选择现有位置或输入新位置 |
图 4：准备配对——对话框确认设备已在线
当您输入时，对话框会检查设备是否在线，并在找到设备时显示 Device is online。如果您看到 "This device is not online yet. Make sure it is powered on and connected."，请确认设备已通电且网络连接正常（HDMI 屏幕会显示其网络状态），稍等片刻后重试。一个设备一次只能属于一个设施——如果它已在其他地方配对，请先在那里移除它，或者如果是您的设备，请使用 Move to another facility。
点击 Add，配对过程将在数秒内完成：设备将接收其设施身份、安全连接详情以及默认设置。
添加 Cloud Agent
在 Add Agent 对话框中，选择 Cloud Agent 以打开 Add Cloud Agent："Choose a name, region, and size. The agent is added to this facility automatically."（“选择名称、地区和规格。智能代理将自动添加到此设施中。”）
图 5：添加 Cloud Agent —— 名称、地区和规格
- Name — 所有人将在智能代理切换器中看到的名称，例如 Retail Ops Cloud Agent 或 Head Office Agent。
- Region — Cloud Agent 实例运行的地区。系统会为您自动选择对您而言延迟最低的地区。如需选择其他地区，请点击 Choose a different region，在列表中搜索并选择一个。请选择靠近智能代理使用人群的地区，或符合您数据驻留需求的地区。
- Size — Small、Medium 或 Large，每种规格都有其对应的资源、每小时价格和每月预估费用。Medium 标注为常规工作负载的推荐规格；Small 仅适用于 "Only for very simple, lightweight or budget-conscious agents that will do minimal work."（“极度简单、轻量或预算有限且仅执行最少工作的智能代理。”）。点击 Show all instance sizes 查看更多选项。"Cloud Agents are charged based on the size and resources you provision."（“Cloud Agent 根据您配置的规格和资源进行计费。”）——View pricing docs 中提供了详细信息。
- 可选：展开高级设置（见下文）。
- 点击 Launch。
图 6：为 Cloud Agent 选择其他地区
随后，对话框会显示启动进度 —— Provisioning the instance、Initialising agent 和 Adding to this facility —— 直到显示 Cloud agent is ready。"Setting up this region for the first time may take a few extra minutes."（“首次设置此地区可能需要额外几分钟。”）您无需等待："Progress updates here automatically. You can leave this page and come back."（“此处的进度会自动更新。您可以离开此页面并在稍后返回。”）
如果启动失败，对话框会进行提示，并显示 "Nothing was charged for this attempt."（“此尝试未产生任何费用。”）。请重试，或选择其他规格或地区。
高级设置（可选）
两个对话框中均包含一个高级设置部分，用于在添加智能代理时更改默认设置。此处的任何设置以后都可以在 Device management 中更改，因此如果不确定，请保留默认设置。
图 7：添加 Physical Agent 时的各项高级设置
图 8：添加 Cloud Agent 时的各项高级设置
- Restore from a backup — 默认关闭。"Seed this agent from another device's cloud backup — including devices that have been removed."（“使用其他设备的云备份初始化此智能代理——包括已被移除的设备。”）选择备份源和恢复点，智能代理将以此备份的状态启动。请参阅恢复与还原。
- Cloud backup — 默认开启，Keep backups for 设置为 90 天，Storage regions 设置为 Automatic。如果您有数据驻留要求，可以提前调整保留期限或选择特定的存储地区。请参阅备份。
- MCP access — 默认开启，范围限定于此设施。"Lets the agent use Performance Hub tools through a device-bound service account. You can refine what it can access later in the agent's settings."（“允许智能代理通过设备绑定的服务账号使用 Performance Hub 工具。您可以在稍后的智能代理设置中精细控制其可访问的内容。”）请参阅连接到 Performance Hub。
- Restrict access to this agent — 默认关闭，因此任何有权访问该设施的人都可以打开此智能代理。开启此项后，"Only you will be able to open it. You can grant access to others later in the agent's settings."（“只有您才能打开它。您可以在稍后的智能代理设置中向其他人授予访问权限。”）请参阅访问控制。
- Budgets & limits — "Optional spend caps for this agent's AI usage. All limits are off by default."（“针对此智能代理 AI 使用情况的可选消费上限。所有限制默认均为关闭状态。”）开启每日限制、每月限制或生命周期上限并输入金额。请参阅 Budgets & limits。
添加智能代理的用户将自动成为其在访问控制方面的所有者（owner）。
第三步 —— 认识您的智能代理
系统会自动在代理切换器中选中新代理，并加载其界面。全新代理需要几分钟进行初始设置；模块会显示设置进度，并在准备就绪后立即打开代理，无需刷新。
对于全新代理，代理内部的简短设置向导会引导您完成四个快速步骤：
- 设置基本信息。 为您的代理命名，并选择其行为方式：向其发送中途任务消息时的处理方式（立即引导，或将消息排队作为后续处理）以及它如何处理命令审批。
- 根据需要进行迁移。 可选择将现有助手的 Memory、技能和聊天记录从另一台计算机导入，如果是全新开始则可跳过此步。请参阅迁移到您的代理。
- 做个自我介绍。 告知代理您的姓名和角色、组织情况以及您希望它协助处理的日常事务。所有信息都会进入其长期 Memory 并塑造其 Personality。
- 观看简短演示。 一分钟的实时导览：阅读网页、处理文件、跨对话记忆内容以及安排任务，最后提供根据您所述内容量身定制的建议。
您可以随时跳过向导并在稍后完成——在完成之前，向导会再次出现，并且它设置的所有内容随后都可以在代理的设置中更改。完成后，代理聊天即可处理您的第一个请求——请参阅使用您的代理。
第 4 步 — 分派一项实际任务
注意： 代理在 Performance Hub 中可以看到的内容取决于您的设施连接了哪些模块和集成。依赖实时数据（例如访客、预订、门禁事件等）的示例需要将这些数据从 AI Insights & People 等模块或其他连接的系统流入 Performance Hub。如果您的设施未连接某个模块，代理会告知您它无法查看该数据。
展示其功能的优秀首要任务：
- “在 Performance Hub 中你能为本设施看到什么？” — 观察它列举其功能。
- “对比上周，总结本周的访客数据。” — 实时数据，第一个问题。
- “每个工作日早上 7 点，准备一份简短的晨间简报并通过通知提醒我。” — 您的第一个包含推送通知的自动化。
- 将电子表格或 PDF 拖入对话中并要求总结 — 它会进入代理的 Workspace。
从其他 AI 代理平台迁移？内置的迁移技能可以导入旧代理的数据 — 请参阅迁移到您的代理。
已处理完成的内容
由于添加代理会连通所有内容，请注意您无需执行的操作：无需 AI 模型 API 密钥（已通过 auto 模型预连接），无需备份设置（从第一小时起每小时备份），无需更改防火墙，无需安装软件。建议执行的剩余步骤是快速查看 Budgets & limits 以设置您满意的每月消费上限。
相关页面
- 使用您的代理 — 日常工作
- Device management — 指标、更新和设置
- 硬件 — AI Agent Processor、放置位置和配对二维码贴纸
- 故障排除 — 配对问题及修复