快速开始
从安装 AGI 到接入首个消息渠道、配置本地模型并完成首次对话，最短路径掌握核心流程。本页带你走完初始化、接入、配置与对话的完整路径，了解本地优先的工作方式。
ℹ️ 本地优先说明
AGI 是本地优先（local-first）的 AI 智能体应用。大语言模型通过 llama.cpp 在设备端运行，你的对话记录、模型与相关数据默认保存在本机，不强制上传云端。技术栈为 llama.cpp、Flutter、Kotlin。
01安装与初始化
AGI 面向桌面与移动端设备，请在支持的平台上安装，并确保设备具备足够的存储空间与内存以运行本地模型。
- 下载安装从官方渠道下载对应平台的安装包，完成安装后启动 AGI。
- 完成初始化引导首次启动会进入初始化引导，选择数据目录、确认本地存储位置，并设置基础访问口令。
- 确认运行环境检查设备是否满足运行 llama.cpp 的最低要求（内存、算力），必要时在「模型配置」中调整。
ℹ️ 关于数据目录
初始化时选择的数据目录会保存模型文件、对话记录与配置。请将其放在有足够空间的磁盘上，并注意备份。数据自持机制详见数据自持机制技术文档。
02接入首个消息渠道
AGI 通过「消息渠道」与外界交互。接入一个渠道后，你便可以在该入口向智能体发送消息并接收响应。
- 进入渠道管理在主界面进入「消息渠道」页面，点击「添加渠道」。
- 选择渠道类型根据你的使用场景选择渠道类型（如本机会话、Web 控制台入口、或你自有消息服务）。
- 填写接入配置按提示填写接入地址、令牌或密钥等连接信息，并完成授权。
- 启用并测试启用渠道后发送一条测试消息，确认智能体能够正常响应。
🔒 渠道凭据安全
渠道接入涉及令牌、密钥等凭据。请妥善保管，勿在公开场合泄露。凭据管理遵循数据自持机制中的本地加密存储原则。
03配置本地模型
AGI 需在设备端运行大语言模型。你需要先准备一个模型文件，并在「模型配置」中加载。
- 获取模型文件下载与设备能力匹配的 GGUF 格式模型文件（如量化版本），放入数据目录的模型文件夹。
- 导入模型在「模型配置」页面点击「添加模型」，选择本地模型文件并命名。
- 加载并校验加载模型，确认 llama.cpp 后端能够正常推理，调整上下文长度与线程数以获得最佳性能。
- 设为默认将加载好的模型设为默认模型，供对话与技能调用。
04完成首次对话
完成渠道接入与模型配置后，即可开始首次对话。
- 打开对话在已接入的渠道或 Web 控制台中打开对话窗口。
- 发送消息输入问候或提问，智能体将调用本地模型进行推理并返回响应。
- 尝试技能尝试让智能体调用技能（如查询本机信息、执行受控操作），体验系统能力深度操控。
⚠️ 使用边界
AGI 可对设备进行深度操控，请仅在充分理解的前提下授权技能执行。涉及敏感操作（如删除、修改配置文件）会要求二次确认，请谨慎操作。
05上手速查表
| 目标 | 操作路径 | 要点 |
|---|---|---|
| 安装初始化 | 下载安装 → 初始化引导 → 设置数据目录 | 确保空间与内存充足 |
| 接入渠道 | 消息渠道 → 添加渠道 → 配置 → 启用 | 妥善保管令牌与密钥 |
| 配置模型 | 模型配置 → 添加模型 → 加载 → 设为默认 | 选择匹配设备能力的量化版本 |
| 首次对话 | 打开对话 → 发送消息 → 尝试技能 | 敏感操作需二次确认 |
📌 免责声明
本页面内容仅供学习与使用参考。AGI 对设备的深度操控存在一定风险，请自行判断、自担风险。使用本应用即表示你已理解并接受相关风险。