StackTrace.AI 1.0.2

StackTrace.AI

Intelligent error analysis for .NET applications

📋 What is StackTrace.AI?

StackTrace.AI automatically captures exceptions in your .NET application, analyzes them using AI (Groq/OpenAI/Gemini), and provides detailed explanations, causes, solutions, and best practices.

✨ Features

🧠 How AI Analysis Works (Prompt Engineering)

StackTrace.AI uses carefully crafted prompts to ensure high-quality, consistent AI responses. Each error analysis follows a structured approach:

System Prompt (English)

You are a senior .NET and C# expert with 10 years of experience.
Analyze errors precisely and provide actionable solutions.

Important instructions:
1. Response must be ONLY JSON, no text before or after
2. Use clear, professional English
3. Provide detailed explanation of the problem and root cause
4. Possible causes must be accurate and specific
5. Solution steps must be sequential and applicable
6. Best practices tips should provide real value

System Prompt (Arabic)

أنت خبير متخصص في .NET و C# مع خبرة 10 سنوات. 
تحليل الأخطاء بدقة وتقديم حلول عملية قابلة للتنفيذ فوراً.

تعليمات مهمة:
1. يجب أن يكون الرد JSON فقط بدون أي كلام قبله أو بعده
2. استخدم لغة عربية فصحى واضحة
3. قدم شرحاً مفصلاً للمشكلة وجذرها
4. الأسباب المحتملة يجب أن تكون دقيقة ومحددة
5. خطوات الحل يجب أن تكون متسلسلة وقابلة للتطبيق
6. نصائح أفضل الممارسات يجب أن تكون ذات قيمة حقيقية

AI Output Format

The AI always returns a consistent JSON structure:

{
    "error_type": "NullReferenceException",
    "explanation": "Detailed explanation of what caused the error...",
    "possible_causes": ["Cause 1", "Cause 2"],
    "solution_steps": ["Step 1", "Step 2"],
    "best_practices": ["Tip 1", "Tip 2"]
}

Why This Matters

This prompt engineering approach ensures every error analysis is:

• ✅ Consistent — Same structure every time
• ✅ Actionable — Clear steps you can implement immediately
• ✅ Educational — Learn best practices with each error
• ✅ Bilingual — High quality in both Arabic and English

🚀 Quick Start

1. Install the Package

dotnet add package StackTrace.AI

2. Configure in Program.cs

using StackTraceAI;

var builder = WebApplication.CreateBuilder(args);

// Add StackTrace.AI services
builder.Services.AddStackTraceAI(builder.Configuration);

var app = builder.Build();

// Use StackTrace.AI middleware
app.UseStackTraceAI();

app.Run();

3. Set API Key

Add your API key to appsettings.json:

{
  "DefaultLanguage": "ar",
  "AI": {
    "DefaultModel": "groq"
  },
  "Groq": {
    "ApiKey": "your-groq-key-here"
  }
}

4. Test

# Create a test error
curl -X GET https://localhost:5001/api/errors/test-error/null

# Open interactive dashboard
open https://localhost:5001/api/report/dashboard-url

📚 API Endpoints

🤖 Supported AI Models

📄 License

MIT License

Made with curiosity and love — to help every .NET developer build better software ✨

Report Bug • Request Feature