Action Tools
These tools create, modify, or trigger operations in Orion.ask_orion
Send a natural language question to Orion and get an AI-powered data analysis response. This is the primary tool for interacting with Orion.Orion performs multi-step analyses that take 1-2 minutes. After calling
ask_orion, use get_conversation_history to poll for the final response.
Wait at least 30 seconds between polls.create_conversation
Start a new Orion conversation.execute_metric
Trigger execution of a metric to refresh its current value.run_workflow
Trigger a workflow run. Returns the created run, including its id. Runs take minutes, so poll get_workflow_run_reports with that id to see outputs as they land.create_wiki_page
Create a knowledge base page or folder. The page is created immediately, with no review step.update_wiki_page
Update an existing knowledge base page. Only the fields you pass change. An edit to an unlocked page applies immediately, with no review. On a locked page, only the page creator edits directly. For every other caller the change is submitted as a change request. See Locking Pages and the Change Request Flow.delete_artifact
Delete a slide deck, dashboard, or report artifact. This is a destructive action.Read-Only Tools
These tools only read data and are safe to call without confirmation.list_projects
List Orion projects the user has access to.list_users
List all users in the Orion organization. Returns user ID, name, and role.list_conversations
List chat conversations for a user.get_conversation_history
Read messages from an existing Orion conversation. Use this to poll for results after callingask_orion.
list_metrics
List metrics (KPIs) and views for a project. A view is a dataset metric Orion does not display whole, because it exists as a checkpoint for further analysis. A table metric is the same shape at a size you can read.get_metric
Get full metric detail including definition, Python code, data sources, and latest result.get_metric_results
Get historical execution results for a metric, newest first.get_metric_insights
Get auto-detected metric insights showing significant changes and anomalies for a project.list_workflows
List the workflows for a project.get_workflow
Get workflow detail, including its definition (steps and outputs) and its schedule.get_workflow_results was replaced by the three tools below. Calling it now
returns an error. Reading a run’s outputs takes three steps:
get_workflow_runs for the run id, get_workflow_run_reports for that run’s
artifacts, then get_workflow_report_content for the content.get_workflow_runs
List a workflow’s runs, newest first. Each run carries an id: pass it to get_workflow_run_reports to see what that run produced.get_workflow_run_reports
List the report artifacts one workflow run produced. Markdown reports, slide decks, podcasts, and CSV exports each appear as one item with a format and an id. When an item carries ashare_url, that is its full public link: share that exact URL rather than assembling one.
get_workflow_report_content
Read one report artifact’s content. Markdown reports, slide decks, and dashboards return their content as markdown. Podcast audio is not readable inline, so this returns a short-lived signed download URL instead.list_artifacts
List slide decks, dashboards, or reports for a project.get_artifact
Get the content of a slide deck, dashboard, or report as markdown.search_wiki
Search the Orion wiki/knowledge base.get_wiki_page
Get one knowledge base page with its full markdown content.get_wiki_page_by_path
Get a knowledge base page by its hierarchical path, for example/internal/icp.