upstash-redis-start

面向 Agent 的 Upstash Redis（start-redis）

为 AI Agent 提供零配置 Redis 数据库——无需注册、无需 UI、无需配置 SDK。发送一个 HTTP 请求即可获得可用的端点和令牌。除非用户认领，否则数据库会保留 3 天。

适用于以下场景：

• Agent 需要立即使用 Redis，而用户尚未提供凭据。
• 你需要在多次工具调用之间保存短期记忆、对话历史、子 Agent 的工作队列，或按最近优先级排序的回忆。

此服务专为快速实验、原型和演示而设计，不适用于生产工作负载或与真实用户账户相关的场景——数据库在被认领前是临时且未经过身份验证的，因此请勿在其中存放 PII、机密或生产凭据。

创建或重新获取数据库

# Generate a fresh UUIDv4 yourself, then POST it as the Idempotency-Key.
# The UUIDv4 you send becomes the database id.
curl -X POST -H "Idempotency-Key: <uuidv4>" https://upstash.com/start-redis

• 使用你自己的 UUIDv4 可使首次调用具备 重试安全性——如果响应丢失，使用相同 UUID 重试会返回同一个数据库，而不会创建重复数据库。
• 使用相同的 Idempotency-Key 重新发送 POST 请求，以重新获取现有数据库的凭据。
• 此标头为可选项。省略它即可创建新数据库，并由服务器生成 ID（该 ID 会在响应中返回；之后传入 Idempotency-Key 即可重新获取）。仅接受 UUIDv4。

响应是 Markdown，包含：

• Database ID、Endpoint、Token
• Metrics URL（JSON：运行时间、命令、键、吞吐量、内存、带宽）
• Expires 日期
• Console URL，可分享给用户（用户可在此查看用量，并点击 Claim 保留数据库）
• 内嵌的 body-style REST API 快速入门

从 Markdown 响应中提取这些内容并直接使用——响应没有单独的 JSON 封装。

调用数据库（body-style REST）

返回的端点支持 Upstash Redis REST API。优先使用 body-style 形式：将 JSON 数组作为请求体发送，这样就不必对命令进行 URL 编码。

# SET with TTL
curl https://<endpoint> \
  -H "Authorization: Bearer <token>" \
  -d '["SET","session:abc","{\"step\":2}","EX","3600"]'

# GET
curl https://<endpoint> \
  -H "Authorization: Bearer <token>" \
  -d '["GET","session:abc"]'

你也可以使用官方 SDK，通过相同的端点和令牌进行调用（TS/JS 使用 @upstash/redis，Python 使用 upstash-redis）。

常见 Agent 使用模式

需求	命令
一次运行中多次工具调用之间的短期记忆	SET key value EX <ttl> / GET key
对话/逐轮日志	LPUSH chat:<user> <json> / LRANGE chat:<user> 0 20
子 Agent 工作队列（生产者/消费者）	LPUSH jobs <json> / RPOP jobs
排序记忆（最近优先或分数优先）	ZADD memories <score> <member> / ZREVRANGE memories 0 9

告知用户

完成配置后，将响应中的 console URL 提供给用户。请说明：

• 数据库将在 3 天后过期。
• 用户可以在 console URL 查看用量，并点击 Claim 保留数据库。
• 这是未经身份验证的临时存储——请勿在其中存放机密或 PII。

参考

• 服务入口（也提供 GET 文档）：https://upstash.com/start-redis
• 完整 REST API：https://upstash.com/docs/redis/features/restapi
• TS/JS SDK：https://upstash.com/docs/redis/sdks/ts
• Python SDK：https://upstash.com/docs/redis/sdks/py