This is an automated email from the ASF dual-hosted git repository. github-merge-queue[bot] pushed a commit to branch gh-readonly-queue/dev/pr-13113-2010a1fedbb20590ab18f69a52374478fc1e797d in repository https://gitbox.apache.org/repos/asf/seatunnel.git
commit 8a81d13ea9c34610c430b5d47695e08af4091b34 Author: Hyacinth-of-Security <[email protected]> AuthorDate: Tue Nov 17 15:25:30 2026 +0000 [Doc][Connector-Mem0] Add the sink options table (#13113) Co-authored-by: lxcxjxhx <[email protected]> --- docs/en/connectors/sink/Mem0.md | 20 ++++++++++++++++++++ docs/zh/connectors/sink/Mem0.md | 20 ++++++++++++++++++++ 2 files changed, 40 insertions(+) diff --git a/docs/en/connectors/sink/Mem0.md b/docs/en/connectors/sink/Mem0.md index 893c59281e..7cf5aa2c20 100644 --- a/docs/en/connectors/sink/Mem0.md +++ b/docs/en/connectors/sink/Mem0.md @@ -7,6 +7,26 @@ add API. Phase 1 supports `ADD` only. A row is acknowledged only when the API returns a non-empty `event_id`; this is accepted at-least-once delivery, not completion of asynchronous processing. + +## Sink Options + +| Name | Type | Required | Default | Description | +|----------------|--------|----------|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| api_key | String | Yes | - | Mem0 Platform API key. Sent as `Authorization: Token <api_key>`. | +| api_base_url | String | No | `https://api.mem0.ai` | Mem0 Platform V3 API base URL. | +| messages_field | String | Yes | - | Input row field holding the messages payload. It must resolve to an array. | +| user_id_field | String | No | - | Input row field mapped to Mem0 `user_id`. | +| agent_id_field | String | No | - | Input row field mapped to Mem0 `agent_id`. | +| app_id_field | String | No | - | Input row field mapped to Mem0 `app_id`. | +| run_id_field | String | No | - | Input row field mapped to Mem0 `run_id`. | +| metadata_field | String | No | - | Input row field mapped to Mem0 `metadata`. It must resolve to a JSON object. | +| retry | Integer | No | - | Maximum number of retries when an HTTP request fails with an `IOException`. | +| retry_backoff_multiplier_ms | Integer | No | `100` | Retry-backoff interval in milliseconds used as the multiplier when a request fails. | +| retry_backoff_max_ms | Integer | No | `10000` | Maximum retry-backoff interval in milliseconds when a request fails. | +| common-options | | No | - | Sink plugin common parameters, please refer to [Sink Common Options](../common-options/sink-common-options.md) for details. | + +At least one of `user_id_field`, `agent_id_field`, `app_id_field` and `run_id_field` must be configured and non-empty for every row. The three `retry*` options are inherited from the shared HTTP sink options and apply to request failures. + ## Configuration ```hocon diff --git a/docs/zh/connectors/sink/Mem0.md b/docs/zh/connectors/sink/Mem0.md index 5709a2ffa1..624f12f78e 100644 --- a/docs/zh/connectors/sink/Mem0.md +++ b/docs/zh/connectors/sink/Mem0.md @@ -6,6 +6,26 @@ Mem0 Sink 将 SeaTunnel 行写入托管版 Mem0 Platform V3 异步添加接口 只支持 `ADD`。只有接口返回非空 `event_id` 时才确认该行;这表示“已接受的至少一次 投递”,不代表 Mem0 异步处理已经完成。 + +## Sink 选项 + +| 名称 | 类型 | 是否必填 | 默认值 | 描述 | +|------------------|--------|----------|------------------------|------------------------------------------------------------------------------------------| +| api_key | String | 是 | - | Mem0 Platform API Key,以 `Authorization: Token <api_key>` 发送。 | +| api_base_url | String | 否 | `https://api.mem0.ai` | Mem0 Platform V3 API 基础地址。 | +| messages_field | String | 是 | - | 保存 messages 载荷的行字段,必须解析为数组。 | +| user_id_field | String | 否 | - | 映射到 Mem0 `user_id` 的行字段。 | +| agent_id_field | String | 否 | - | 映射到 Mem0 `agent_id` 的行字段。 | +| app_id_field | String | 否 | - | 映射到 Mem0 `app_id` 的行字段。 | +| run_id_field | String | 否 | - | 映射到 Mem0 `run_id` 的行字段。 | +| metadata_field | String | 否 | - | 映射到 Mem0 `metadata` 的行字段,必须解析为 JSON 对象。 | +| retry | Integer | 否 | - | HTTP 请求以 `IOException` 失败时的最大重试次数。 | +| retry_backoff_multiplier_ms | Integer | 否 | `100` | 请求失败时的重试退避间隔(毫秒),作为退避倍率使用。 | +| retry_backoff_max_ms | Integer | 否 | `10000` | 请求失败时的重试退避上限(毫秒)。 | +| common-options | | 否 | - | Sink 插件通用参数,请参考 [Sink 通用选项](../common-options/sink-common-options.md)。 | + +`user_id_field`、`agent_id_field`、`app_id_field`、`run_id_field` 这四个范围字段中,至少有一个必须在每一行上配置且非空。三个 `retry*` 选项继承自通用 HTTP sink 选项,作用于请求失败。 + ## 配置 ```hocon
