Octop第一次对话指南:Web控制台Chat功能上手教程
2026/9/20 12:05:28 网站建设 项目流程

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 名称与吉祥物,下方是「快捷提示卡片」,点击即自动填充示例问题
会话列表左侧栏,保存所有历史对话,可随时切换、重命名、删除
输入框底部核心区域,支持多行输入、附件上传、斜杠命令与上下文选择

发出第一条消息很简单

  1. 点击欢迎屏上任意一张快捷卡片,或直接输入你的问题;
  2. 按 Enter 发送,等待 Agent 回复;
  3. 回复支持 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询