故障排除

以下是关于如何修复在使用 Pydantic AI 时可能遇到的一些常见错误的建议。如果您遇到的问题未在下面列出或在文档中未得到解决，请随时在 Pydantic Slack 中提问或在 GitHub 上创建 issue。

Jupyter Notebook 错误

RuntimeError: This event loop is already running (运行时错误: 此事件循环已在运行)

此错误是由 Jupyter Notebook 和 Pydantic AI 中的事件循环冲突引起的。管理这些冲突的一种方法是使用 nest-asyncio。即，在执行任何代理运行之前，请执行以下操作：

import nest_asyncio

nest_asyncio.apply()

注意：此修复方法也适用于 Google Colab 和 Marimo。

API 密钥配置

UserError: API key must be provided or set in the [MODEL]_API_KEY environment variable (用户错误: 必须提供 API 密钥或在 [MODEL]_API_KEY 环境变量中设置)

如果您在为模型设置 API 密钥时遇到问题，请访问模型页面，了解有关如何设置环境变量和/或传入 api_key 参数的更多信息。

监控 HTTPX 请求

您可以在模型中使用自定义的 httpx 客户端，以便在运行时访问特定的请求、响应和标头。

使用 logfire 的 HTTPX 集成来监控上述内容特别有帮助。