> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent

> 通过工具、Skill、plugin 和现成整合，将 Agent 接入已部署的 ReMe 服务。

本页介绍使用共享服务的 Agent 接入。请先[部署 ReMe 服务](/reme/latest/zh/integration/services)，再选择 Agent 如何连接，以及何时召回或记录记忆。AgentScope 的进程内 `ReMeMiddleware` 应使用 [Python 接入](/reme/latest/zh/integration/python#agentscope)。

## 选择接入模式

以下模式的区别在于如何封装服务调用与记忆行为：

| 模式     | 提供的能力                               | 适用场景                      |
| ------ | ----------------------------------- | ------------------------- |
| 直接调用工具 | 通过 MCP、CLI 或 HTTP 调用服务              | 已经管理工具调用和会话生命周期的自定义 Agent |
| Skill  | 定义何时通过服务 client 搜索、读取和记录            | 支持通用 Agent Skill 的宿主      |
| Plugin | 将连接配置、工具或 Skill、生命周期 hook 打包为宿主专用方案 | 已有 ReMe plugin 的宿主        |

三种模式最终连接同一个服务边界：

```text theme={null}
Agent ── 工具 / Skill / plugin ──> MCP / CLI / HTTP ──> ReMe 服务 ──> workspace
```

Agent 侧的接入不负责管理 ReMe 进程。它负责选择服务接口、提供会话上下文，并决定返回的记忆是否以及如何影响回答。

### Skill

Skill 是服务接口之上的行为层，不是服务或传输方式。仓库内置的 [`skills/reme_memory/`](https://github.com/agentscope-ai/ReMe/tree/main/skills/reme_memory) 使用 ReMe CLI；其他宿主也可以通过 MCP 工具或 HTTP 应用相同的行为。

使用 Skill 时，将完整的 `skills/reme_memory/` 目录安装到宿主的 skill 位置，确保 `SKILL.md` 和配套规则一起保留。之后宿主应遵循以下约定：

1. 回答过往对话、偏好、决定或项目历史前，先搜索，再读取命中的相关文件；
2. 只记录具有长期价值的事实、偏好、决定和经验，不默认保存密钥或敏感信息；
3. 会话结束或出现稳定信息时调用 `auto_memory`，并使用宿主会话生命周期提供的稳定 `session_id`；
4. 将 `auto_dream` 交给 ReMe 定时任务，或由宿主按自身生命周期触发；
5. 将 ReMe 视为记忆输入，最终是否以及如何使用结果仍由 Agent 决定。

Skill 不负责启动 ReMe，也不会自行补全缺失的对话历史。

### Plugin

Plugin 将特定宿主所需的服务连接配置、工具、Skill 和会话 hook 等能力打包在一起。它应连接已经部署的 ReMe 服务，并利用宿主生命周期实现自动召回或记录。安装 plugin 并不意味着它会启动或管理 ReMe。

## 维护中的集成

ReMe 目前为以下宿主提供了现成的整合方案：

| 宿主          | 接入方式                | 召回                          | 记录             |
| ----------- | ------------------- | --------------------------- | -------------- |
| Claude Code | ReMe plugin         | MCP 工具与 `reme-memory` Skill | Stop hook 自动记录 |
| QwenPaw     | `reme_memory` Skill | ReMe CLI                    | QwenPaw 会话生命周期 |

下面分别介绍这些方案的宿主专用配置与验证步骤。

## Claude Code

Claude Code plugin 组合了 MCP 召回、召回 skill 和异步会话记录。它只连接共享的 ReMe MCP 服务，不会自行启动 ReMe。

### 1. 启动 ReMe

先按[快速开始](/reme/latest/zh/quickstart)安装 ReMe，再保持 MCP 服务运行：

```bash theme={null}
reme start service.backend=mcp service.transport=streamable-http
```

默认端点为 `http://127.0.0.1:2333/mcp`。自动记录还需要配置 LLM 环境。

### 2. 安装 Plugin

克隆 ReMe 仓库，在仓库根目录通过 Claude Code 添加内置 marketplace 并安装 plugin：

```text theme={null}
/plugin marketplace add ./plugins/claude_code
/plugin install reme@reme-marketplace
```

重启 Claude Code，运行 `/mcp`，确认名为 `reme` 的 server 和工具已经连接。

Package 位于 `plugins/claude_code/`：`.mcp.json` 定义服务地址，`reme-memory` skill 控制召回，`hooks/auto_memory.py` 在会话结束后调用 `auto_memory_cc`。

### 3. 验证召回与记录

先在终端写入一条容易识别的记忆：

```bash theme={null}
reme write \
  path=digest/wiki/claude-code-check \
  name="Claude Code Check" \
  description="Claude Code 接入验证" \
  content="项目约定：提交前先运行 pytest。"
```

随后让 Claude Code 回答“这个项目提交前要做什么？”。它应先搜索并读取 ReMe，再根据记忆回答。

接着结束一段包含长期信息的对话，稍后搜索其中的关键词：

```bash theme={null}
reme search query="<刚才对话中的关键词>" limit=5
```

Stop hook 异步运行，并采用 best-effort 策略：ReMe 服务不可用时不会阻塞 Claude Code。修改服务端口时，还需同步更新 `plugins/claude_code/reme/.mcp.json`。Hook 覆盖项和日志位置见 [plugin README](https://github.com/agentscope-ai/ReMe/blob/main/plugins/claude_code/README.md)。

## QwenPaw

QwenPaw 通过上文介绍的 ReMe Skill 接入。Skill 定义 Agent 何时召回或记录，ReMe 服务负责持久化、索引和整理。

### 1. 启动 ReMe

保持默认 HTTP 服务运行：

```bash theme={null}
reme start
```

对话提炼和长期整合需要配置[快速开始](/reme/latest/zh/quickstart#5-按需启用记忆演化)中的 LLM 环境。

### 2. 安装 ReMe Skill

将仓库中的完整 [`skills/reme_memory/`](https://github.com/agentscope-ai/ReMe/tree/main/skills/reme_memory) 目录安装到 QwenPaw 的 skill 位置，确保 `SKILL.md` 和行为规则一起保留。

加载后，QwenPaw 应遵循以下规则：

* 回答过去对话、偏好、决定或项目历史前，先搜索并读取；
* 只用 `auto_memory` 记录具有长期价值的信息，不保存每轮对话；
* 写入敏感信息前取得用户明确同意；
* 由自身的会话生命周期提供稳定的 `session_id`。

<Note>
  `skills/qwenpaw_memory` 会直接维护 `MEMORY.md` 和 `memory/*.md`，不会调用 ReMe。接入 ReMe 时应使用 `skills/reme_memory`。
</Note>

### 3. 验证召回与记录

先在终端写入验证记忆：

```bash theme={null}
reme write \
  path=digest/personal/qwenpaw-check \
  name="QwenPaw Check" \
  description="QwenPaw 接入验证" \
  content="用户偏好：解释技术问题时先给结论。"
```

然后让 QwenPaw 回答“我偏好怎样的技术解释？”。确认它先搜索 ReMe，并读取刚写入的文件。

再提供一条具有长期价值的信息，结束会话后搜索相关关键词。如果当前 QwenPaw 版本没有会话结束 hook，可以由应用层显式调用 `auto_memory`，或先仅启用召回；不要自行补全缺失的消息历史。