Lists perspectives — either browsing one workspace or searching by title across every workspace the user can access. Items include perspective_id, title, status, conversation count, and workspace info.
Behavior:
- Read-only.
- Browse mode (workspace_id, no query): lists every perspective in that workspace.
- Search mode (query): matches against the perspective title across accessible workspaces. Optional workspace_id narrows the search. Query must be non-empty and ≤200 chars.
- Errors with "Please provide workspace_id to list perspectives or query to search." if neither is given.
- Pass nextCursor back as cursor; has_more indicates further results.
When to use this tool:
- Resolving a perspective_id from a name the user mentioned (search mode).
- Browsing a workspace's perspectives to pick or summarize.
When NOT to use this tool:
- Inspecting one known perspective in detail — use perspective_get.
- Aggregate counts or rates — use perspective_get_stats.
- Fetching conversation data — use perspective_list_conversations or perspective_get_conversations.
Examples:
- List all in a workspace: `{ workspace_id: "ws_..." }`
- Search by name across all workspaces: `{ query: "welcome" }`
- Search within a workspace: `{ query: "welcome", workspace_id: "ws_..." }`
Connector