Explain a setting or metric
Use the documentation and workspace configuration to explain current product behavior.
When to use this workflow
“How do visibility and citation rate differ, and what does this configuration measure?”
Before fetching
Separate general product questions from questions about this workspace. Answer pricing and limit questions only from documented or contractual values.
Complete the CLI quickstart and confirm the workspace with orc workspace current --json. Replace example IDs, URLs, dates, and settings. Apply only approved mutations.
1. Read the documented behavior
Read the relevant page in the CLI reference, and use help to check arguments. Use the agent’s browsing capability to read documentation. Do not infer billing or retention behavior from command syntax.
orc reports visibility get --help
orc reports citations get --help2. Inspect configuration when the answer depends on it
Check the selected workspace and prompt. Skip this fetch when the user only asks for a metric definition.
orc workspace current --json
orc prompts get YOUR_PROMPT_ID --jsonDeliverable
Return the answer, documentation URLs, relevant configuration values, and anything the documentation does not establish.
On fetch failure, retain the error and request scope. Do not count empty data, incomplete pagination, or missing permissions as a completed investigation.
Next steps
If a failure remains, report it and verify the fix, including this workflow and the failed step.