创建 IM 集成 - MemoryLake 中国站

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/admin/v1/integrations' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "010480e33a3f952c9d61c9f8d39bb410",
    "channel": "dingtalk",
    "credentials": {
      "appId": "example",
      "appKey": "example",
      "appSecret": "example",
      "appToken": "example",
      "botId": "example",
      "botToken": "example",
      "secret": "example"
    },
    "name": "Example name",
    "read_write_project_id": "b60e42e8ed8f4c1a4eca1eaa53ad7c90",
    "workspace_id": "9c542f78770f7e85ff018ddfc2c63541",
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "agent_id": "9926a90400d85f0a54e9e195e915db44",
    "channel": "dingtalk",
    "created_at": 1760000000,
    "credentials_configured": false,
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
    "id": "f58008acc066bab6dfb73de8efde8905",
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    },
    "status": "pending",
    "updated_at": 1760000000,
    "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
    "status_error": "example",
    "status_error_code": "credentials_invalid"
  }
}

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/admin/v1/integrations' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "010480e33a3f952c9d61c9f8d39bb410",
    "channel": "dingtalk",
    "credentials": {
      "appId": "example",
      "appKey": "example",
      "appSecret": "example",
      "appToken": "example",
      "botId": "example",
      "botToken": "example",
      "secret": "example"
    },
    "name": "Example name",
    "read_write_project_id": "b60e42e8ed8f4c1a4eca1eaa53ad7c90",
    "workspace_id": "9c542f78770f7e85ff018ddfc2c63541",
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    }
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "agent_id": "9926a90400d85f0a54e9e195e915db44",
    "channel": "dingtalk",
    "created_at": 1760000000,
    "credentials_configured": false,
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
    "id": "f58008acc066bab6dfb73de8efde8905",
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    },
    "status": "pending",
    "updated_at": 1760000000,
    "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
    "status_error": "example",
    "status_error_code": "credentials_invalid"
  }
}

POST /openapi/memorylake/admin/v1/integrations

将 DingTalk、WeCom、Feishu 或 Slack 机器人连接到某个 Agent。集成会立即启用，初始状态为 pending。DingTalk、Feishu 和 Slack 凭据会在保存任何内容前向平台验证（通过 access token 交换或 auth.test——不会发送消息）；WeCom 凭据通过建立连接来检查，因此请用获取 IM 集成跟踪 status。一个机器人只能连接一次。您还需要对 read_write_project_id 拥有写权限，并对每个只读项目拥有检索权限。

所需权限： workspace:integration_manage（作用于 workspace_id）

设置了 read_write_project_id 时：project:mem_add（作用于 read_write_project_id）
设置了 read_only_project_ids 时：project:mem_search（作用于 read_only_project_ids）

请求头

string

可选。使用相同值重试会重放首次结果，而不会创建第二个集成。不比较凭据值。

请求体

string

required

负责回复发送给该机器人的消息的 Agent

string

required

IM 平台。必须已在此部署上启用。可选值：dingtalk、wecom、feishu、slack。

object

required

仅可写入。dingtalk：appKey + appSecret；feishu：appId + appSecret；slack：botToken + appToken；wecom：botId + secret。DingTalk、Feishu 和 Slack 的凭据会在保存前向平台校验。

Show Integration Credentials 对象

string

飞书：App ID。用于标识机器人；创建后不可更改。

string

DingTalk：Client ID（AppKey）。用于标识机器人；创建后不可更改。

string

DingTalk：Client Secret（AppSecret）。Feishu：App Secret。

string

Slack：具有 connections:write 权限的 App-Level Token（xapp-…）。

string

WeCom：智能机器人的 Bot ID。用于标识机器人；创建后不可更改。

string

Slack：Bot User OAuth Token（xoxb-…）。不支持启用了令牌轮换的应用。

string

WeCom：智能机器人的 Secret。

string

required

显示名称

string

required

从 IM 对话中提取的记忆写入的项目。任何能向机器人发送消息的人都可以向其中添加内容。

string

required

集成所属的工作空间。之后无法更改。

integer

每天处理的最大消息数；省略或传 0 表示不限

array

Agent 可使用的开放数据数据集

array

额外检索的项目（只读）。不得与 read_write_project_id 重复。

object

渠道专属设置

Show Integration Settings 对象

string

仅限 DingTalk：AI 卡片模板 ID。设置后回复将以流式写入交互卡片；省略或发送 "" 则以普通消息回复。

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/admin/v1/integrations' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Idempotency-Key: 7c1d2e3f-0a9b-4c8d-b7e6-f5a4d3c2b1a0' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": "010480e33a3f952c9d61c9f8d39bb410",
    "channel": "dingtalk",
    "credentials": {
      "appId": "example",
      "appKey": "example",
      "appSecret": "example",
      "appToken": "example",
      "botId": "example",
      "botToken": "example",
      "secret": "example"
    },
    "name": "Example name",
    "read_write_project_id": "b60e42e8ed8f4c1a4eca1eaa53ad7c90",
    "workspace_id": "9c542f78770f7e85ff018ddfc2c63541",
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    }
  }'

响应

object

Show Integration 对象

string

负责回复发送给该机器人的消息的 Agent

string

IM 平台。可选值：dingtalk、wecom、feishu、slack。

integer

创建时间，Unix 秒级时间戳

boolean

是否已存储凭据。凭据本身仅可写入，从不返回。

integer

此集成每天处理的最大消息数；0 表示不限

array

Agent 可使用的开放数据数据集

boolean

是否应连接该集成

string

机器人在 IM 平台上的标识符（DingTalk Client ID、Feishu App ID、WeCom Bot ID、Slack team:bot-user）。不属于机密信息。

string

集成的标识符

string

显示名称

array

额外检索的项目（只读）

string

从 IM 对话中提取的记忆写入的项目

object

渠道专属设置

Show Integration Settings 对象

string

仅限 DingTalk：AI 卡片模板 ID。设置后回复将以流式写入交互卡片；省略或发送 "" 则以普通消息回复。

string

连接状态。创建后或更改凭据后为 pending，直至首次连接尝试；可轮询获取 IM 集成跟踪状态。可选值：pending、connected、error、disabled。

integer

最后更新时间，Unix 秒级时间戳

string

集成所属的工作空间。创建时确定。

string

status 为 error 时的简短规范化原因，用于展示（中文，采用控制台措辞，可能变化）。绝不包含平台的原始响应。程序中请使用 status_error_code。

string

稳定的原因代码，只要存在 status_error 就会返回。credentials_invalid：平台拒绝了凭据（请修正凭据）；subscribe_rejected：WeCom 拒绝了订阅——凭据错误或触发平台限流，会自动重试；preempted：另一个连接接管了该机器人，通常是同一机器人在另一环境中建立了连接；timeout / disconnected / connection_aborted / connection_failed：连接问题，会自动重试；dependency_unavailable：此部署依赖的某项服务不可用，会自动重试；dependency_misconfigured：此部署缺少该渠道所需的组件（WeCom 需要 Redis）——请联系运维人员；internal_error：我方故障；unknown：该原因记录于原因代码引入之前，会在下次连接尝试时被替换。今后可能新增代码；遇到无法识别的代码时，请按 connection_failed 处理。

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "agent_id": "9926a90400d85f0a54e9e195e915db44",
    "channel": "dingtalk",
    "created_at": 1760000000,
    "credentials_configured": false,
    "daily_message_limit": 1,
    "dataset_ids": [
      "3748f84ef0d2e877c0097b8f32d45cf0"
    ],
    "enabled": true,
    "external_app_id": "524832f3cb1ba8ef33208d0692b8d565",
    "id": "f58008acc066bab6dfb73de8efde8905",
    "name": "Example name",
    "read_only_project_ids": [
      "5af1515af082229ccfd68f981a6cf886"
    ],
    "read_write_project_id": "aed31b20113b86ecc2587aa0cbc0eb2f",
    "settings": {
      "card_template_id": "870213bad9d43369a8af134b1b482d6e"
    },
    "status": "pending",
    "updated_at": 1760000000,
    "workspace_id": "ce55865bcc4c12c26161d24b238a888e",
    "status_error": "example",
    "status_error_code": "credentials_invalid"
  }
}

​请求头

​请求体

​响应

请求头

请求体

响应