认证

凭据类型

可选的 X-Space-Id 请求头用于指定某个空间；不传时使用该用户的默认空间。

无论用哪种方案，最终都会解析成一个主体（租户 · 用户 · 空间），数据库会话则按这个身份、通过 Postgres 行级安全策略划定范围——也就是说，隔离是在 API 之下强制执行的，而不是靠应用代码。

我该用哪一种？

• 服务端对服务端集成（由你的产品驱动对话）：用代理模式。租户密钥由你的后端持有，每次请求声明终端用户身份——用户永远看不到密钥。
• 你自己的客户端应用，且用户直接登录平台：用终端用户 JWT。
• 管理类自动化（管理文档、智能体、用量）：用纯租户密钥调用管理接口。

代理模式示例

curl https://chat.agent4.io/chat \
  -H "X-API-Key: tk_live_…" \
  -H "X-End-User: crm-user-8841" \
  -H "Content-Type: application/json" \
  -d '{ "message": "What documents do I need for a refinance?" }'

终端用户 ID 可以是你系统里任何稳定的标识符。平台在第一次见到它时创建该用户及其默认空间，并把所有历史、记忆和文档都限定在其范围内。

错误码