debug-single-query-for-cortex-agent
CommunityDebug Cortex agent queries end-to-end.
Authorrandoneering
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Interactively debug Cortex agent query failures to identify routing, SQL, or response issues. Use when investigating why a specific query fails or produces incorrect results.
Core Features & Use Cases
- Guided, multi-step debugging workflow covering context establishment, retrieval of the failing query, live trace analysis, and safe application of fixes via agent orchestration.
- Supports debugging production and development runs, including fetching event traces, inspecting tool usage, and validating fixes with re-tests.
- Use Case: When a Cortex agent returns an incorrect answer, follow the interactive steps to reproduce, isolate whether routing, SQL, or model logic is at fault, and implement a controlled change with traceable versioning.
Quick Start
Initiate an interactive debugging session for a failing Cortex agent query and follow the steps to reproduce, analyze, and apply a fix.
Dependency Matrix
Required Modules
requestssnowflake-connector-pythonpandasurllib3trulens
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: debug-single-query-for-cortex-agent Download link: https://github.com/randoneering/nix-flake-mirror/archive/main.zip#debug-single-query-for-cortex-agent Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.