Key-Value Store

Active

A stateless agent forgets everything between calls; this stores values it can read back later.

3 tools

A tiny key-value store so a stateless agent can remember things across calls. Store any JSON value under a key, read it back later, optionally with a time-to-live.

Developer Toolsmemorystatekey-valuestoragepersistence

Tools (3)

▶set

Store a JSON value under a key for this account, optionally with a TTL. Overwrites an existing key.

Free

Example prompts

“Remember that the last processed id was 4821”
“Save this config for later runs”

Parameters

keystringrequired

Key to store under.

valuerequired

Any JSON value.

ttl_hoursintegeroptional

Optional expiry in hours.

API Usage

curl -X POST "https://skill.askfaro.com/skills/kv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Remember that the last processed id was 4821"
  }
}'

CLI Usage

askfaro describe kv/kv.set

Install pip install askfaro-cli, then askfaro auth login.

▶delete

Delete a key. Free.

Free

Example prompts

“Forget the saved config”

Parameters

keystringrequired

API Usage

curl -X POST "https://skill.askfaro.com/skills/kv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Forget the saved config"
  }
}'

CLI Usage

askfaro describe kv/kv.delete

Install pip install askfaro-cli, then askfaro auth login.

▶get

Read the value previously stored under a key. Returns null if missing or expired.

Free

Example prompts

“What was the last processed id?”

Parameters

keystringrequired

API Usage

curl -X POST "https://skill.askfaro.com/skills/kv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What was the last processed id?"
  }
}'

CLI Usage

askfaro describe kv/kv.get

Install pip install askfaro-cli, then askfaro auth login.