agentuity-cli-cloud-keyvalue-set

agentuity 的头像作者 agentuity

在键值存储中设置键和值。需要身份验证。用于Agentuity云平台操作

📖 中文导读:在键值存储中设置键和值。需要身份验证。用于Agentuity云平台操作 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: agentuity-cli-cloud-keyvalue-set description: Set a key and value in the keyvalue storage. Requires authentication. Use for Agentuity cloud platform operations version: "0.0.103" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: " [ttl]" metadata: command: "agentuity cloud keyvalue set" tags: "mutating updates-resource slow requires-auth"

Cloud Keyvalue Set

Set a key and value in the keyvalue storage

Prerequisites

  • Authenticated with agentuity auth login
  • Project context required (run from project directory or use --project-id)

Usage

agentuity cloud keyvalue set <namespace> <key> <value> [ttl]

Arguments

Argument Type Required Description
<namespace> string Yes -
<key> string Yes -
<value> string Yes -
<ttl> string No -

Examples

Store user data:

bunx @agentuity/cli kv set production user:123 '{"name":"Alice","email":"alice@example.com"}'

Store session with 1h TTL:

bunx @agentuity/cli kv set cache session:abc "session-data-here" --ttl 3600

Cache homepage for 10m:

bunx @agentuity/cli kv set staging cache:homepage "<!DOCTYPE html>..." --ttl 600

Output

Returns JSON object:

{
  "success": "boolean",
  "namespace": "string",
  "key": "string",
  "contentType": "string",
  "durationMs": "number",
  "ttl": "number"
}
Field Type Description
success boolean Whether the operation succeeded
namespace string Namespace name
key string Key name
contentType string Content type (application/json or text/plain)
durationMs number Operation duration in milliseconds
ttl number TTL in seconds if set