> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# App Diagnostics

Validate your app's health and readiness before deployment.

***

## Overview

Diagnostics performs comprehensive checks across all app components—agents, tools, events, memory, and orchestration logic. It automatically detects missing or misconfigured elements and prioritizes issues for efficient remediation.

```
Run Diagnostics → Scan Configuration → Identify Issues → Generate Report → Fix Issues
```

## Running Diagnostics

1. Navigate to your app's **Overview** page.
2. Click **Run Diagnostics**.
3. Wait for the scan to complete.
4. Review the diagnostic report.

## What Gets Checked

| Category      | Checks                                                                                                                        |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Agents**    | Configuration completeness, tool linkages, knowledge connections, instruction quality, deprecated bindings                    |
| **Tools**     | Workflow tool deployment status, code tool syntax errors, MCP server connectivity, parameter validation, missing dependencies |
| **Events**    | Event trigger configuration, workflow bindings, parameter mappings, handler assignments                                       |
| **Knowledge** | Search AI application links, index status, connector health, data freshness                                                   |
| **System**    | Graph compilation, LLM configuration, orchestration logic, environment variables                                              |

<Note>Diagnostics performs static and logical validation. It evaluates configuration health. Use [Playground](/agent-platform/agents/agentic-apps/simulation-and-testing) to test conversational outcomes.</Note>

## Report Structure

### Severity Levels

| Level       | Icon | Meaning                                    |
| ----------- | ---- | ------------------------------------------ |
| **Error**   | 🔴   | Critical issue preventing deployment       |
| **Warning** | 🟡   | Potential problem that should be addressed |
| **Info**    | 🔵   | Informational note or suggestion           |

### Report Views

**Overview Tab**: High-level summary

<div class="ascii-art">
  ┌──────────────────────────────────────────────────┐
  │ Diagnostics Report                               │
  ├──────────────────────────────────────────────────┤
  │                                                  │
  │ Status: ⚠️ Issues Found                          │
  │                                                  │
  │ 🔴 Errors:    2                                  │
  │ 🟡 Warnings:  3                                  │
  │ 🔵 Info:      5                                  │
  │                                                  │
  └──────────────────────────────────────────────────┘
</div>

**Agents Tab**: Agent-specific issues

<div class="ascii-art">
  ┌────────────────────────────────────────────────────┐
  │ Agents                                             │
  ├────────────────────────────────────────────────── ─┤
  │                                                    │
  │ Support Agent                                      │
  │ 🔴 Missing tool: get\_order\_status (not deployed)   │
  │ 🟡 Knowledge source 'faq\_db' index is stale        │
  │    \[Fix now]                                       │
  │                                                    │
  │ Billing Agent                                      │
  │ ✅ No issues found                                 │
  │                                                    │
  └────────────────────────────────────────────────────┘
</div>

**Tools Tab**: Tool-specific issues

<div class="ascii-art">
  ┌────────────────────────────────────────────────────┐
  │ Tools                                              │
  ├────────────────────────────────────────────────────┤
  │                                                    │
  │ Workflow Tools                                     │
  │ 🔴 process\_refund: Not deployed                    │
  │    \[Deploy now]                                    │
  │                                                    │
  │ MCP Tools                                          │
  │ 🟡 crm\_tools: Server connection timeout            │
  │    Last successful connection: 2 hours ago         │
  │    \[Test connection]                               │
  │                                                    │
  │ Code Tools                                         │
  │ ✅ All code tools validated                        │
  │                                                    │
  └────────────────────────────────────────────────────┘
</div>

## Common Issues

### Missing Tool Deployment

```
🔴 Error: Tool 'get_order_status' is not deployed

Agent 'Support Agent' references this tool but it hasn't been
deployed. The agent won't be able to invoke it.

Fix: Navigate to Tools → get_order_status → Deploy
```

### Stale Knowledge Index

```
🟡 Warning: Knowledge source 'product_catalog' index is stale

Last indexed: 7 days ago
Source last updated: 2 days ago

Some responses may use outdated information.

Fix: Navigate to Knowledge → product_catalog → Reindex
```

### Missing Environment Variables

```
🔴 Error: Environment variable 'API_KEY' is not set

Tool 'external_api_call' requires this variable but it's
not configured in the current environment.

Fix: Navigate to Settings → Environment → Add variable
```

### MCP Server Unreachable

```
🟡 Warning: MCP server 'enterprise_tools' is unreachable

Connection attempts failed for the past 15 minutes.
Tools from this server won't be available.

Fix: Check server status or update connection settings
```

### Agent Without Tools

```
🔵 Info: Agent 'FAQ Agent' has no tools configured

This agent can only use knowledge retrieval and won't be
able to take actions. This may be intentional for
information-only agents.
```

## Quick Fixes

Many issues include a **\[Fix now]** button:

| Issue             | Quick Fix Action                    |
| ----------------- | ----------------------------------- |
| Tool not deployed | Opens deployment dialog             |
| Stale index       | Triggers reindexing                 |
| Missing link      | Opens configuration page            |
| Invalid config    | Opens editor with issue highlighted |

## Validation Rules

Diagnostics applies consistent standards:

### Agents Must Have

* ✅ Name and description
* ✅ At least one capability (tools or knowledge)
* ✅ Valid AI model configured
* ✅ All linked tools deployed

### Tools Must Have

* ✅ Name and description
* ✅ Valid parameter definitions
* ✅ Successful test execution
* ✅ Deployed status (for workflow tools)

### Events Must Have

* ✅ Trigger condition defined
* ✅ Handler workflow linked
* ✅ Parameters mapped correctly

## Best Practices

### Run Before Every Deployment

Make diagnostics part of your deployment checklist:

```markdown theme={null}
Pre-deployment:
1. [ ] Run diagnostics
2. [ ] Fix all errors
3. [ ] Review warnings
4. [ ] Create version
5. [ ] Deploy to staging
6. [ ] Test in staging
7. [ ] Deploy to production
```

### Address Warnings

While warnings don't block deployment, they often indicate issues that will affect users.

### Regular Health Checks

Run diagnostics periodically, not just before deployment:

* Catch configuration drift.
* Detect external service issues.
* Maintain system health.

## Limitations

Diagnostics performs **static and logical validation** only:

| Checks                     | Doesn't Check        |
| -------------------------- | -------------------- |
| Configuration completeness | Conversation quality |
| Tool connectivity          | Response accuracy    |
| Dependency resolution      | User satisfaction    |
| Syntax validation          | Edge case handling   |

<Tip>For conversation testing, use the **Playground** feature to simulate real interactions.</Tip>

***