Octop第一次对话指南:Web控制台Chat功能上手教程
【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop
Octop 是一个开源、自托管的多用户多 Agent AI 助手,它的 Web 控制台 Chat 功能让你安装完成后几分钟内就能与自己的 AI 助手开始第一次对话。本教程带你从零走通完整流程:登录控制台、认识对话界面、发出第一条消息,并掌握斜杠命令、附件上传、多 Agent 切换等常用操作,帮你快速上手 Octop AI 助手。
第一步:启动 Octop 并登录 Web 控制台
启动 Octop 只需一条命令,首次访问会自动引导你完成初始配置:
octop run启动后在浏览器打开http://127.0.0.1:8088。首次访问会自动跳转到设置向导,依次完成:选择控制面数据库(默认 SQLite,开箱即用)→ 创建管理员账号(密码至少 8 位且含字母和数字)→ 配置模型(可先跳过,稍后在「设置 → 模型」中补充)。
💡 向导中的模型步骤可以跳过,但对话前至少需要一个可用的 LLM 供应商(OpenAI 兼容 API、DeepSeek、Ollama 本地模型等均可)。配置方法见 docs/user-guide.md 的「四、配置模型」章节。
认识对话主界面:你的第一条消息从这里开始
登录后进入对话(Chat)页面,这就是 Octop 的核心交互区:
界面由三部分组成:
| 区域 | 作用 |
|---|---|
| 欢迎屏 | 显示当前 Agent 名称与吉祥物,下方是「快捷提示卡片」,点击即自动填充示例问题 |
| 会话列表 | 左侧栏,保存所有历史对话,可随时切换、重命名、删除 |
| 输入框 | 底部核心区域,支持多行输入、附件上传、斜杠命令与上下文选择 |
发出第一条消息很简单:
- 点击欢迎屏上任意一张快捷卡片,或直接输入你的问题;
- 按 Enter 发送,等待 Agent 回复;
- 回复支持 Markdown 渲染,工具调用过程、知识库引用都会可视化展示。
🐾 小提示:点击欢迎屏上的吉祥物图片,它会切换成另一个表情——纯属彩蛋,但能让你确认第一次对话的心情是轻松的。
第一次对话前建议:选对 Agent
Octop 支持多 Agent 架构,每个 Agent 拥有独立的工作区、供应商与技能。第一次对话时你可以使用默认 Agent,但更推荐从专家库一键创建专业角色(写作、编程、数据分析等),还可以用 MBTI 人格模板为 Agent 赋予鲜明性格:
在对话输入框上方的 Agent 选择器中,随时可以切换到不同 Agent 继续聊天——切换后仍保留各自的会话历史。
常用斜杠命令速查:让第一次对话更高效
在输入框中输入/会弹出命令菜单,常用命令如下:
| 命令 | 作用 |
|---|---|
/status | 查看当前 Agent 运行状态 |
/new | 开启新会话(别名/clear) |
/history | 查看历史消息统计 |
/list | 列出会话 |
/token | 查看 Token 用量 |
/compact | 压缩上下文 |
这些命令由后端统一下发,详见 dashboard/src/utils/slashFallbackCommands.ts 与斜杠命令入口 dashboard/src/pages/Chat/components/SlashCommandMenu.tsx。
进阶技巧:附件、知识库与多轮对话
第一次对话顺畅后,试试这几个能立刻提升体验的功能:
- 📎附件上传:输入框支持上传文件作为对话上下文,Agent 可读取并分析内容;
- 📚知识库引用:已配置知识库的 Agent 会附带引用来源,点击可回溯原文(实现见 dashboard/src/utils/parseKnowledgeCitations.ts);
- 💬多轮对话:上下文自动延续,用
/compact可压缩长对话以节省 Token; - 🔁排队消息:Agent 回复期间继续输入会进入队列,无需干等。
遇到问题怎么办
| 问题 | 解决方法 |
|---|---|
| 控制台打不开 | 确认已执行octop run,访问端口是否正确(默认 8088) |
| 发送后无回复 | 检查该 Agent 是否已配置可用模型,可在「设置 → 模型」中测试连接 |
| 测试连接失败 | 核对 API Key、Base URL、网络连通性与账户配额 |
| 忘记密码 | 通过控制台「个人设置 → 修改密码」管理;详见 docs/user-guide.md 的「常见问题」 |
下一步可以探索
完成第一次对话后,Octop 还有更多玩法等你解锁:
- 通道(Channels):把 Agent 接入飞书、钉钉、QQ、Discord、企业微信,在 IM 里也能聊;
- 定时任务(Cron):用自然语言让 Agent 每天按时推送或执行任务;
- 浏览器 AI+ 与远程桌面:网页自动化与实时键鼠操控,入口在控制台「控制」页;
- 本地模型:接入 Ollama 可实现完全离线对话,隐私更安心。
更多细节可参考官方文档 docs/user-guide.md、docs/configuration.md 与架构说明 docs/architecture.md。现在,打开终端输入octop run,开始你和 Octop 的第一次对话吧!🚀
【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考