agentune-analyze 0.1.1

Analyze AI agents to understand their performance and get improvement suggestions to make them better

Agentune Analyze & Improve

---

Turn real conversations into insights that measurably improve your AI agents.

Agentune Analyze & Improve helps teams discover what drives an agent’s KPIs up or down — and generate concrete recommendations to enhance performance.
It transforms messy operational data into interpretable, data-driven actions that actually move business metrics.

---

Why It Matters

Most AI agents are optimized by intuition: a few sample chats, some prompt edits, and best guesses.

Agentune replaces guesswork with evidence.
Using structured and unstructured data from real conversations, it:

• Identifies patterns that correlate with KPI outcomes
• Surfaces interpretable insights (not opaque scores)
• Recommends targeted changes to prompts, policies, and logic

No more trial-and-error tuning — just measurable improvement grounded in data.

For example: suppose you built a sales agent and now have a dataset of conversations with labeled outcomes as win, undecided, or lost. Using Agentune Analyze & Improve, you can discover insights showing which patterns or intents correlate with those outcomes and receive concrete recommendations to refine the agent’s playbook — for instance, improving how it handles discounts, competitor mentions, or shipping questions.

How It Works

Agentune Analyze & Improve follows a transparent, two-step process:

1. Analyze

• Ingests conversations, outcomes, and optional context data (e.g., product, policy, CRM).
• Generates semantic and structural features that capture patterns in language, behavior, or flow.
• Selects statistically significant features correlated with KPI changes — these become your drivers of performance.

Example insights:

• “Mentions of competitors early in chat increase conversion probability.”
• “Discount discussion combined with shipping-time questions lowers CSAT.”

2. Improve

• Maps the discovered drivers into actionable recommendations — changes to prompts, tool usage, escalation logic, or playbooks.
• Outputs a ranked list of improvement opportunities, each linked to its supporting data.

These recommendations can then be validated using Agentune Simulate before deployment.

---

Example Usage

1. Getting Started - 01_getting_started.ipynb for an introductory walkthrough of library fundamentals
2. End-to-End Script Example - e2e_script_example.md - a runnable example executing the entire analysis workflow
3. Advanced Examples - advanced_examples.md for customizing components, using LLM requests caching, and advanced workflows

Testing & Costs

We've tested Agentune Analyse with the combination of OpenAI o3 and gpt-4o-mini. In our tests, the cost per conversation was approximately 5-10 cents per conversation.

Installation

pip install agentune-analyze

Requirements

• Python ≥ 3.12
• Note for Mac users: If you encounter errors related to lightgbm, you may need to install OpenMP first: brew install libomp. See the LightGBM macOS installation guide for details.

---

Key Features

• 🧩 Feature Generation – semantic, structural, and behavioral signals derived from real interactions
• 📈 Feature Selection – statistical and semantic correlation with target KPIs
• 💡 Actionable Insights – interpretable drivers with examples and metrics
• 🧠 Context Awareness (upcoming) – integrates CRM, product, and policy metadata for deeper understanding

---

Roadmap

Current focus: structured context integration for richer analysis and smarter recommendations.

Planned milestones:

• Support for context-aware feature generation
• Integration of context data into the recommendation engine
• Visualization tools for insight exploration
• Seamless flow into agentune-simulate for validating improvements

---

Contributing

We welcome contributions that strengthen the analysis and recommendation layers.

• Contact us at [e-mail]

---