neuron-debugger

Trace Neuron agent execution with Inspector APM observability.

2.0k|233|Updated Mar 2, 2025
One-click install
npx skills add https://github.com/neuron-core/neuron-ai --skill neuron-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuron-debugger
Source: https://github.com/neuron-core/neuron-ai/tree/main/skills/neuron-debugger
Command: npx skills add https://github.com/neuron-core/neuron-ai --skill neuron-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Debugging and monitoring Neuron AI applications is simplified by Inspector APM and the framework's observability system, providing clear insight into agent execution, tool usage, and performance bottlenecks.

## Core Features & Use Cases

  • Inspector APM integration for end-to-end execution tracing and latency analysis across LLM inferences, tool calls, and workflow nodes.
  • Event system observability via a static EventBus with example event mappings and custom observers for tailored telemetry.
  • Logging and production error analysis workflows, with guidance for tracing, exporting diagrams, and diagnosing poor response quality.

### Quick Start Install Inspector, configure the ingestion key, and run an agent to start collecting and viewing execution data.

Frequently Asked Questions about neuron-debugger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug Neuron AI agent execution and trace tool calls?

You can debug Neuron AI agent execution by integrating Inspector APM to trace tool calls, LLM inferences, and workflow nodes end-to-end. Basic tracking requires no code changes, only configuring the Inspector ingestion key.

What is observability in Neuron AI applications and how does the EventBus work?

Observability in Neuron AI uses a static EventBus for event monitoring, allowing you to attach custom observers to collect telemetry on agent execution steps and diagnose performance bottlenecks.

Do I need to modify my code to start monitoring LLM inference latency?

No code changes are required for basic tracking of LLM inference latency. You simply install Inspector, configure the ingestion key, and run your agent to start collecting and viewing execution data.

Can I use custom observers to log specific agent workflow events?

Yes, you can extend basic tracking by configuring custom observers via the EventBus to log specific agent workflow events, tailoring telemetry for diagnosing errors and poor response quality.

What's the best way to diagnose poor response quality in AI applications?

The best way to diagnose poor response quality is using Inspector APM logging and tracing capabilities to analyze production errors, export execution diagrams, and review workflow node performance bottlenecks.

Why does my AI agent experience high latency during tool calls?

High latency during tool calls can be diagnosed by running the agent with Inspector APM integration, which provides end-to-end execution tracing to pinpoint performance bottlenecks across workflow nodes.