> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-zh/agent/error-handling.md).

# 错误处理

Neuron AI 抛出的所有异常都是以下内容的扩展 `NeuronException` . 有几种异常可以帮助你理解哪里出了问题，但由于它们继承自同一个根异常，因此你能够在代码上下文中准确检测代理错误：

```php
try {

    // 你的代码在这里...

} catch (NeuronAI\Exceptions\NeuronException $e) {
    // ...
} catch (NeuronAI\Exceptions\ProviderException $e) {
    // ...
} catch (NeuronAI\Exceptions\AgentException $e) {
    // ...
} catch (NeuronAI\Exceptions\ChatHistoryException $e) {
    // ...
} catch (NeuronAI\Exceptions\HttpException $e) {
    // ...
} catch (NeuronAI\Exceptions\ToolException $e) {
    // ...
} catch (NeuronAI\Exceptions\VectorStoreException $e) {
    // ...
} catch (NeuronAI\Exceptions\WorkflowException $e) {
    // ...
} catch (NeuronAI\Exceptions\DataReaderException $e) {
    // ...
}
```

### 监控与调试

如果你希望在任何错误发生时收到提醒，请考虑连接 [**Inspector**](https://inspector.dev/) 到你的应用程序。

在上述链接注册后，请务必设置 `INSPECTOR_INGESTION_KEY` 在应用程序环境文件中的变量。

{% code title="项目根目录中的 .env" %}

```
INSPECTOR_INGESTION_KEY=nwse877auxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

{% endcode %}

代理将自动进行埋点。了解更多，请访问 [文档](/neuron-v3-zh/agent/observability.md) 以了解其他配置选项。

<figure><img src="/files/c04d5b8b201bc3a9560a7b62efdf717a47e4c3c5" alt=""><figcaption></figcaption></figure>
