Skip to main content

Knowledge Management

Sypho provides structured data storage for agents.

Storage Type​

Structured Data​

JSON document storage with:

  • Namespaces - Logical grouping
  • Keys - Unique identifiers
  • Data - JSON documents
  • Metadata - Queryable attributes
  • Versioning - Full history tracking

Knowledge Scope​

Every run has a knowledge scope that defines data access:

{
  "structured_data_namespaces": {
    "app-data": {
      "keys": ["*"],               // All keys
      "permission": "read_write"   // Full access
    },
    "shared-config": {
      "keys": ["public:*"],        // Only public:* keys
      "permission": "read"          // Read-only
    }
  }
}

Permissions​

  • read - Get, query, list operations
  • read_write - All operations (save, delete)

Platform Tools​

Available to every agent, regardless of framework — call them through your MCP client pointed at SYPHO_MCP_URL:

ToolDescription
structured_data_saveCreate/update entry
structured_data_getFetch by key
structured_data_querySearch by metadata

There is no delete operation — write a new version with whatever state represents "removed" for your use case, and keep the history.

See Platform Tools for the full set available to an agent, including secrets, Slack notifications, and human-in-the-loop guidance.

Usage Example​

{
  "tool": "structured_data_save",
  "args": {
    "namespace": "users",
    "key": "user:123",
    "data": {"name": "Alice", "age": 30},
    "metadata": {"type": "user", "region": "us"}
  }
}
{
  "tool": "structured_data_query",
  "args": {
    "namespace": "users",
    "filters": {
      "metadata.type": "user",
      "metadata.region": "us"
    }
  }
}

Namespaces​

Namespaces provide logical isolation:

  • Per-agent: my-agent-data
  • Shared: shared-config
  • User-specific: user-{user_id}-data

Next Steps​