> 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/dai-li/error-handling.md).

# 错误处理

管理由你的 Agent 触发的错误。

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 %}

Agent 将自动进行埋点。了解更多请参见 [文档](https://docs.neuron-ai.dev/neuron-v3-zh/dai-li/observability.md) 了解其他配置选项。

<figure><img src="https://99736354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGHx4l2LknIex7vFIUg1R%2Fuploads%2FHvQndveNiX2R0D8q7Fzg%2Finspector.png?alt=media&amp;token=14c7db94-20b8-40a3-9617-c906560bba29" alt=""><figcaption></figcaption></figure>
