find_route_decisions
Find agent route decisions recorded as Langfuse SPAN observations using filters for provider, router, session, and trace. Supports pagination and flexible output.
Instructions
Find generic agent route decisions emitted as Langfuse SPAN observations.
This tool is router-neutral. It only treats observations with
metadata.schema_version == "mcp.route_decision.v1" as route decisions, and
it filters on fields inside observation metadata rather than display output.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Number of minutes to look back (positive integer, max 7 days/10080 minutes) | |
| page | No | Page number for pagination (starts at 1) | |
| limit | No | Maximum number of route decisions to return per page | |
| provider | No | Optional route-decision metadata provider filter | |
| trace_id | No | Optional Langfuse trace ID filter | |
| session_id | No | Optional route-decision metadata session_id filter | |
| decision_id | No | Optional route-decision metadata decision_id filter | |
| output_mode | No | Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized as a string. 'full_json_file': Returns a summarized JSON object AND saves the complete data to a file. | compact |
| router_name | No | Optional route-decision metadata router_name filter | |
| capability_id | No | Optional route-decision metadata capability_id filter |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |