--- title: Web 控制台 description: 通过 Web 控制台使用 CowAgent --- Web 控制台是 CowAgent 的默认通道,启动后会自动运行,通过浏览器即可与 Agent 对话,并支持在线管理模型、技能、记忆、通道等配置。 ## 配置 ```json { "channel_type": "web", "web_port": 9899 } ``` | 参数 | 说明 | 默认值 | | --- | --- | --- | | `channel_type` | 设为 `web` | `web` | | `web_port` | Web 服务监听端口 | `9899` | ## 访问地址 启动项目后访问: - 本地运行:`http://localhost:9899` - 服务器运行:`http://:9899` 请确保服务器防火墙和安全组已放行对应端口。 ## 密码保护 Web 控制台默认无需密码即可访问。如果部署在公网环境,建议配置访问密码: ```json { "web_password": "your_password" } ``` | 参数 | 说明 | 默认值 | | --- | --- | --- | | `web_password` | 访问密码,留空表示不启用密码保护 | `""` | | `web_session_expire_days` | 登录会话有效天数 | `30` | 配置密码后,访问控制台时需先输入密码完成登录。登录状态默认保持 30 天,期间重启服务也无需重新登录。修改密码后,所有已登录的会话将自动失效。 密码也支持在控制台的「配置」页面中在线修改。 ## 功能介绍 ### 对话界面 支持流式输出,可实时展示 Agent 的思考过程(Reasoning)和工具调用过程(Tool Calls),更直观地观察 Agent 的决策过程: #### 多会话管理 对话界面支持多会话(Session)管理,所有会话记录持久化存储在数据库中: - **会话列表**:点击左侧历史会话图标可展开/收起会话列表面板,支持滚动加载全部历史会话 - **AI 生成标题**:新会话在首轮对话完成后,自动调用模型生成简短的会话摘要标题 - **新建会话**:点击会话列表顶部的「新对话」按钮或输入区的 `+` 按钮创建新会话 - **删除会话**:点击会话项的删除按钮,确认后永久删除该会话及其所有消息 - **清除上下文**:点击输入区的清除按钮,在当前会话中插入一条分隔线,分隔线以上的消息仍然展示但不再作为模型的上下文输入 ### 模型管理 支持在线管理模型配置,无需手动编辑配置文件: ### 技能管理 支持在线查看和管理 Agent 技能(Skills): ### 记忆管理 支持在线查看和管理 Agent 记忆: ### 通道管理 支持在线管理接入通道,支持实时连接/断开操作: ### 定时任务 支持在线查看和管理定时任务,包括一次性任务、固定间隔、Cron 表达式等多种调度方式的可视化管理: ### 日志 支持在线实时查看 Agent 运行日志,便于监控运行状态和排查问题: