Lessons

Lessons are reusable instructions, domain facts, and operating rules that Sovara can retrieve for future agent runs. Every sovara lessons subcommand requires --project-id (or --proj-id). The selector accepts a full project ID, an unambiguous ID prefix, or an exact project name. Examples below use a shell variable to keep commands readable:

PROJECT=support-agent

List and read lessons

sovara lessons list --project-id "$PROJECT"
sovara lessons list --project-id "$PROJECT" --path "support/refunds/"
sovara lessons get <lesson-id> --project-id "$PROJECT"

ls is the folder-oriented view:

sovara lessons ls --project-id "$PROJECT" "support/refunds/"

Query lessons for context

sovara lessons query --project-id "$PROJECT" --path "support/refunds/"
sovara lessons retrieve --project-id "$PROJECT" "Customer asks for a refund exception"

Use query to render lessons in a folder. Use retrieve to see which lessons match concrete agent context.

Create a lesson

Creation requires a title, content, and retrieval-oriented usage hint:

sovara lessons create \
  --project-id "$PROJECT" \
  --title "Retry rate-limited provider calls" \
  --content "When an upstream API returns HTTP 429, retry with exponential backoff and jitter." \
  --when-to-use "When a provider request fails because of rate limiting" \
  --path "reliability/providers/" \
  --run-id "<full-run-uuid>"

Use the full run UUID when a lesson comes from a specific run.

Improve a lesson

Ask for a non-mutating wording proposal:

sovara lessons polish <lesson-id> --project-id "$PROJECT"

Apply an update:

sovara lessons update <lesson-id> \
  --project-id "$PROJECT" \
  --content "Retry HTTP 429 responses with exponential backoff and jitter." \
  --run-id "<full-run-uuid>"

Manage folders

sovara lessons mkdir "support/refunds/" --project-id "$PROJECT"
sovara lessons mv -i <lesson-id> "support/refunds/" --project-id "$PROJECT"
sovara lessons cp "support/refunds/" "support/escalations/" --project-id "$PROJECT"

Use restructure commands only when intentionally reorganizing a larger lesson taxonomy. Pass the same explicit project selector to every command.

Get started

Core workflows

Assistant workflows

Reference

List and read lessons

Query lessons for context

Create a lesson

Improve a lesson

Manage folders

​List and read lessons

​Query lessons for context

​Create a lesson

​Improve a lesson

​Manage folders

List and read lessons

Query lessons for context

Create a lesson

Improve a lesson

Manage folders