Searches the public Perspective Agent Library for agent templates that fit a company, audience, or use case. Returns the best matches ranked by relevance, each with a shareable template page URL, a live demo link when available, and a ready-made brief for perspective_create.
Behavior:
- Read-only, public catalog — no workspace is needed and results are the same for every caller.
- query is free text (e.g. "dental clinic new patient scheduling", "SaaS onboarding churn"). Agent templates are ranked by how many query words they match in their title, description, and classification; templates matching none are dropped.
- agent_type, industry, team, outcome, job, journey_stage, replaces, and category are hard filters: within one filter any listed value may match, across filters all must match. Combine a short query with one or two filters for the best recommendations; if total_matches is 0, drop the least certain filter and retry.
- Returns at most limit agent templates (default 10, max 25) plus total_matches so you can tell when a broader set exists.
When to use this tool:
- Recommending agent templates to a new or prospective user based on what you know about their company, role, or goal.
- Finding a starting point before perspective_create — pass the chosen template's create_brief as description and its agent_type as agent_context.
- Answering "do you have an agent template for X?".
When NOT to use this tool:
- You already know the agent template slug and want full details — use agent_template_get.
- Looking for the user's own perspectives — use perspective_list.