使用指南 on AGW

模型提供商

Fri, 25 Sep 2026 00:00:00 +0000

让自定义 Agent 回答问题之前，需要告诉 AGW 使用哪个模型、请求发往哪里，以及如何认证。模型服务商通常会提供 API 地址、模型 ID 和 API Key；请先准备好这些信息。

Fri, 25 Sep 2026 00:00:00 +0000

Agent 是一份可重复使用的助手配置：模型决定它如何理解问题，指令说明它要做什么，工具决定它能执行哪些操作。例如，可以分别创建“代码解释助手”和“文档审查助手”，在 Chat 中按任务选择。

Fri, 25 Sep 2026 00:00:00 +0000

接入外部 Agent 后，任务由 Claude Code、Codex 或 Pi 等外部工具实际执行，AGW 提供统一的配置、对话和工作流入口。你可以继续使用熟悉的外部工具，同时在 AGW 中管理它们的使用方式。

Fri, 25 Sep 2026 00:00:00 +0000

Chat 是向 Agent 或 Agentflow 提交任务、查看结果的地方。同一会话可以连续讨论一个问题，并保留回复和工具活动；不同主题可以新建会话，方便以后查找。

开始前，确认已连接预期的 Server，并有一个可运行的 Agent 或 Agentflow。第一次使用可先完成简单对话。

Fri, 25 Sep 2026 00:00:00 +0000

Project 把一项工作的文件目录、背景资料和会话放在一起。例如，为一个代码仓库创建 Project 后，可以分别建立“阅读代码”和“排查问题”的会话，同时使用同一份工作目录。

Fri, 25 Sep 2026 00:00:00 +0000

Agentflow 指 Agent Workflow（Agent 工作流），把多个处理步骤连接起来。例如，先由一个 Agent 整理材料，再由另一个 Agent 审查，最后请人确认结果。各步骤的输入、输出和先后关系都可以在画布中查看。

Fri, 25 Sep 2026 00:00:00 +0000

Job 用于在指定时间自动运行 Agent 或 Agentflow，适合例行检查和定期整理资料。任务要求、所属 Project 和执行时间保存后，Server 会按计划发起执行，并记录每次结果。

Fri, 25 Sep 2026 00:00:00 +0000

工具（Tool）负责具体操作，例如读取文件；Skill 提供完成某类任务的说明、资源和可选工具。为 Agent 选择能力时，先确定任务需要读什么、改什么，再配置相应工具和说明。

Fri, 25 Sep 2026 00:00:00 +0000

MCP（Model Context Protocol）是一种让 Agent 使用外部工具的协议。MCP 服务会列出自己提供的操作，AGW 连接后可将这些工具交给自定义 Agent 使用。具体能做什么取决于所连接的服务。

Fri, 25 Sep 2026 00:00:00 +0000

集成让自定义 Agent 使用已授权的外部服务账号，例如读取 GitHub 中的资料。同一种服务可以配置多个账号，Agent 选择其中一个使用。当前内建目录提供 GitHub。

开始前，准备服务要求的认证资料，并确认该账号可以访问任务需要的资源。

Fri, 25 Sep 2026 00:00:00 +0000

前提：Server 已完成初始化。客户端不会替代服务端的模型、文件或执行环境。

客户端	连接方式	适用场景
Web	管理员密码或第三方账号登录得到的会话 Cookie；同源 API 访问	浏览器管理与对话
Desktop	API Key，可手动填写或由第三方账号登录签发，支持多个 Server profile	本机或远程的日常工作空间
Mobile	API Key，可手动填写或导入 Web 生成的连接配置，支持多个 Server profile	移动设备上的对话与项目访问

Web 打开 Server 地址；源码开发时打开端口 3001。
Desktop Full 可使用内置 Server。Client 在 Settings → Connections & app 中点击 +（Add remote Server），填写 Name、Server URL 和 API token。远程 Server 使用 http:// 地址时，需要勾选风险确认，说明 API token 和通信内容会在网络上以明文传输。
Mobile 配置可从设备访问的 Server 地址与 API Key；设备上的 localhost 通常不是开发电脑。也可以在 Web 的 Settings → Server access 创建 API Key 后点击 Copy config，再在 Mobile 的 Import Web configuration 中粘贴。删除 Mobile 上的 profile 不会撤销 Server 端的 API Key，需要在 Web 中撤销。
创建一个短会话，确认连接目标、Project 与历史记录。

Desktop 以 Chat 为主界面，Projects 和其他管理入口在 Settings 中。Server profile 切换使用独立缓存，修改地址或 API Key 后，会清除旧连接使用的缓存，避免混入其他 Server 的数据。