> 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/zhi-neng-ti/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/zhi-neng-ti/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>
