解决 ‘agent failed before reply: no api key found for provider “ollama”‘ 错误的完整指南

1次阅读

共计 2249 个字符，预计需要花费 6 分钟才能阅读完成。

在使用 Ollama 作为 AI 服务提供商时，开发者可能会遇到以下错误提示：

agent failed before reply: no api key found for provider "ollama"

这个错误通常发生在以下场景中：

开发者尝试调用 Ollama 的 API，但没有正确配置 API 密钥。
开发环境或生产环境中缺少必要的环境变量设置。
API 密钥在代码中被错误地引用或管理。

这个错误的核心问题是系统无法找到有效的 Ollama API 密钥，导致无法完成 API 请求。接下来，我们将深入探讨如何解决这个问题。

首先，确保你已经从 Ollama 官方获取了有效的 API 密钥。通常，这可以通过以下步骤完成：

登录 Ollama 开发者平台。
导航到 API 密钥管理页面。
生成一个新的 API 密钥或使用现有的密钥。

为了安全地管理 API 密钥，最佳实践是通过环境变量来存储它。以下是具体步骤：

在开发环境中，创建一个 .env 文件，并添加以下内容：

OLLAMA_API_KEY=your_api_key_here

确保 .env 文件被添加到 .gitignore 中，以避免密钥被意外提交到版本控制系统中。
在代码中加载环境变量。例如，在 Python 中可以使用 python-dotenv 库：

from dotenv import load_dotenv
import os

load_dotenv()
api_key = os.getenv("OLLAMA_API_KEY")

除了环境变量，还可以直接在代码中管理 API 密钥，但这种方式不够安全，不推荐在生产环境中使用。以下是一个示例：

api_key = "your_api_key_here"

在调用 Ollama API 之前，建议先验证 API 密钥是否有效。以下是一个简单的验证函数：

import requests

def verify_api_key(api_key):
    headers = {"Authorization": f"Bearer {api_key}"
    }
    response = requests.get("https://api.ollama.com/verify", headers=headers)
    return response.status_code == 200

以下是一个完整的 Python 示例，展示如何正确配置和使用 Ollama API 密钥：

from dotenv import load_dotenv
import os
import requests

# 加载环境变量
load_dotenv()

# 获取 API 密钥
api_key = os.getenv("OLLAMA_API_KEY")

if not api_key:
    raise ValueError("OLLAMA_API_KEY not found in environment variables")

# 设置请求头
headers = {"Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# 调用 Ollama API
try:
    response = requests.post(
        "https://api.ollama.com/v1/chat/completions",
        headers=headers,
        json={
            "model": "gpt-3.5-turbo",
            "messages": [{"role": "user", "content": "Hello!"}]
        }
    )
    response.raise_for_status()
    print(response.json())
except requests.exceptions.RequestException as e:
    print(f"Error calling Ollama API: {e}")