search_assets - Versuno Docs

Performs a full-text search across your Versuno assets and returns results ranked by a compound score of relevance, importance, and recency. Metadata only — no content is loaded into context.

Input

Parameter	Type	Required	Description
`query`	string	Yes	Search query. Specific keywords work better than general phrases.
`type`	enum	No	Filter results to a specific asset type: `context`, `skill`, `persona`, `prompt`, or `system_prompt`.
`limit`	number	No	Max results. Default 10, max 20.

Example

Prompt:

“Search Versuno for anything about customer support.”

Tool call:

{
  "query": "customer support"
}

Response:

Found 4 matches:

- abc123  [prompt]  "Support reply template" (score: 0.92)
- def456  [skill]   "Ticket triage skill" (score: 0.81)
- ghi789  [context] "Support team onboarding" (score: 0.67)
- jkl012  [persona] "Support agent persona" (score: 0.58)

When to use it

The agent has a specific topic in mind and needs the best match.
You want to find related assets before loading them (rather than loading blindly).
Use together with get_asset or pull_asset as a follow-up.

Search tips

Use specific nouns and verbs. “onboarding SQL queries” beats “help me with databases”.
Add type filter if you know what you want. Searching only prompt reduces noise.
The scoring favours recently updated assets with a high importance rating.

See also

list_assets — browse without a query.
get_asset — load the content of a specific match.