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

# 记忆关系图谱

> 写入、列出、删除会话记忆的多关系边，并做有界图检索（Jev-Mem）。

多关系记忆用带类型的边把同一会话内的记忆片段连起来，并支持有界图检索。所有接口都需要 `Authorization: Bearer <api_key>`；未设置 `AGENT_CLOUD_API_KEY` 时可以省略。

## 创建关系边

### 接口

```http theme={null}
POST /v1/agents/sessions/{session_id}/memory/relations
```

### 路径参数

<ParamField path="session_id" type="string" required>
  会话标识符。
</ParamField>

### 请求体

<ParamField body="from_id" type="string" required>
  起始片段 id。
</ParamField>

<ParamField body="to_id" type="string" required>
  目标片段 id。
</ParamField>

<ParamField body="kind" type="string" required>
  关系种类，例如 `causal`、`semantic`、`temporal`。
</ParamField>

<ParamField body="score" type="number">
  边权重，默认 `0.8`。
</ParamField>

<ParamField body="provenance" type="string">
  来源标记，默认 `rest`。
</ParamField>

### 响应

<ResponseField name="session" type="string">
  会话标识符。
</ResponseField>

<ResponseField name="from_id" type="string">
  起始片段 id。
</ResponseField>

<ResponseField name="to_id" type="string">
  目标片段 id。
</ResponseField>

<ResponseField name="kind" type="string">
  关系种类。
</ResponseField>

<ResponseField name="score" type="number">
  边权重。
</ResponseField>

<ResponseField name="provenance" type="string">
  来源标记。
</ResponseField>

<ResponseField name="created_at" type="integer">
  纪元毫秒。
</ResponseField>

## 列出关系边

### 接口

```http theme={null}
GET /v1/agents/sessions/{session_id}/memory/relations
```

### 查询参数

<ParamField query="kind" type="string">
  按关系种类过滤。
</ParamField>

<ParamField query="from" type="string">
  按起始片段 id 过滤。
</ParamField>

<ParamField query="to" type="string">
  按目标片段 id 过滤。
</ParamField>

<ParamField query="top_k" type="integer">
  最多结果数，默认 `50`，限制在 1–200。
</ParamField>

### 响应

返回标准列表信封（`object`、`data`、`has_more`），`data` 是 `RelationItem` 数组。

## 删除关系边

### 接口

```http theme={null}
DELETE /v1/agents/sessions/{session_id}/memory/relations
```

### 查询参数

<ParamField query="kind" type="string">
  按关系种类过滤。
</ParamField>

<ParamField query="from" type="string">
  按起始片段 id 过滤。
</ParamField>

<ParamField query="to" type="string">
  按目标片段 id 过滤。
</ParamField>

`from`、`to`、`kind` 至少要给一个，否则返回 `400`。

### 响应

<ResponseField name="object" type="string">
  固定为 `relation.deleted`。
</ResponseField>

<ResponseField name="session" type="string">
  会话标识符。
</ResponseField>

<ResponseField name="deleted" type="integer">
  删掉的边数。
</ResponseField>

## 图检索

### 接口

```http theme={null}
GET /v1/agents/sessions/{session_id}/memory/relations/graph
```

### 查询参数

<ParamField query="seeds" type="string" required>
  逗号分隔的种子片段 id，至少 1 个。
</ParamField>

<ParamField query="views" type="string">
  逗号分隔的关系种类，限定遍历视野。
</ParamField>

<ParamField query="budget" type="integer">
  遍历预算，默认 `60`。
</ParamField>

<ParamField query="max_hops" type="integer">
  最大跳数，默认 `3`。
</ParamField>

<ParamField query="top_k" type="integer">
  最多返回边数，默认 `20`。
</ParamField>

### 响应

返回 `GraphRetrieveResponse`，`nodes` 和 `edges` 两个数组描述以种子为起点的有界子图。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.