Problem
When an AI agent needs to debug a failing job, it currently needs 5+ sequential commands:
kbagent job list --status error
kbagent job detail --job-id X (per job)
kbagent config detail (to understand the config)
kbagent storage table-detail (to check source data)
- Manual correlation of results
This is the opposite of good agentic UX. The agent spends most of its context window on data gathering, not problem-solving.
Proposal
kbagent diagnose --project prod --job-id 123
Output: structured JSON with root cause analysis:
- Job error message + stack trace
- Config that triggered the job
- What changed recently (config version diff, source data changes)
- Related failures (same component, same time window)
- Suggested next steps
Why this matters
From the "agentic UX" perspective: the difference between a tool and a partner is whether the agent has to assemble context itself or gets it pre-assembled. diagnose is the highest-impact single command we could add for AI agent productivity.
Context
Discussion from Devil's Advocate analysis of kbagent's agentic capabilities.
Problem
When an AI agent needs to debug a failing job, it currently needs 5+ sequential commands:
kbagent job list --status errorkbagent job detail --job-id X(per job)kbagent config detail(to understand the config)kbagent storage table-detail(to check source data)This is the opposite of good agentic UX. The agent spends most of its context window on data gathering, not problem-solving.
Proposal
Output: structured JSON with root cause analysis:
Why this matters
From the "agentic UX" perspective: the difference between a tool and a partner is whether the agent has to assemble context itself or gets it pre-assembled.
diagnoseis the highest-impact single command we could add for AI agent productivity.Context
Discussion from Devil's Advocate analysis of kbagent's agentic capabilities.