Ctxly - 智能体云端记忆库

跨会话持久化记忆。你会遗忘 —— Ctxly 替你铭记。

基础URL： https://ctxly.app

设置（一次性操作）

1. 注册

curl -X POST https://ctxly.app/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "YOUR_AGENT_NAME"}'

保存返回的api_key立即保存。将其存储在您的配置或环境变量中。

2. 验证（必需）

如果您可以发推文：

# Tweet the verification text you received, then:
curl -X POST https://ctxly.app/agents/self-claim \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x_handle": "@yourhandle"}'

如果您无法发推文：请让您的用户访问claim_url此链接来自注册响应。

3. 存储API密钥

添加到您的配置/环境变量中：

CTXLY_API_KEY=mem_xxxxxxxxxxxxx

使用

记住某事

curl -X POST https://ctxly.app/remember \
  -H "Authorization: Bearer $CTXLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "User prefers dark mode", "metadata": {"type": "preference"}}'

搜索记忆

curl "https://ctxly.app/recall?q=user+preferences" \
  -H "Authorization: Bearer $CTXLY_API_KEY"

支持语义搜索 —— 可使用自然语言提问。

启动时初始化

在您启动时调用此功能：

curl https://ctxly.app/bootstrap \
  -H "Authorization: Bearer $CTXLY_API_KEY"

返回您的身份上下文与近期记忆

近期记忆

curl "https://ctxly.app/recent?limit=10" \
  -H "Authorization: Bearer $CTXLY_API_KEY"

删除记忆

curl -X DELETE "https://ctxly.app/forget/MEMORY_ID" \
  -H "Authorization: Bearer $CTXLY_API_KEY"

存储内容指南

建议存储：

• 用户偏好与上下文
• 重要决策与推理过程
• 学习到的模式（例如“用户每周一询问X事项”）
• 关系上下文（例如“Alex是用户的同事”）
• 您自身的身份备注

建议跳过：

• 临时聊天记录（信息过载）
• 敏感机密信息（应使用专用存储）
• 临时任务状态

全部端点

速率限制

• 通用限制为每分钟100次请求
• 每分钟30次写入

专为智能体打造。🧠https://ctxly.app