错误现象分析
当用户尝试使用 AutoGen 库配置本地 LLM 服务（例如通过 LM Studio 启动的 Llama 2 模型），并在 config_list 中指定 api_type: "open_ai" 时，程序会抛出 TypeError: create() got an unexpected keyword argument 'api_type' 异常。以下是典型的错误代码示例：
from autogen import AssistantAgent, UserProxyAgent
config_list = [
{
"api_type": "open_ai", # 导致错误的原因
"api_base": "http://localhost:1234/v1",
"api_key": "NULL"
}
]
llm_config = {'config_list': config_list}
assistant = AssistantAgent(
name="assistant",
llm_config = llm_config
)
user_proxy = UserProxyAgent(
name="user_proxy",
human_input_mode="NEVER",
max_consecutive_auto_reply=100,
)
task = """write a python method to output numbers 1 to 100"""
user_proxy.initiate_chat(
assistant,
message=task
)运行上述代码将产生类似以下的错误堆栈信息：
TypeError: create() got an unexpected keyword argument 'api_type'
此错误明确指出 create() 方法不接受 api_type 参数。尽管在 AutoGen 的早期版本或某些示例中可能存在此参数，但为了与 OpenAI 官方 API 保持一致性，AutoGen 核心库已移除对 api_type 的显式支持。现在，只要 api_base 指向一个兼容 OpenAI API 规范的端点（例如 /v1 路径），AutoGen 就会自动将其视为 OpenAI 兼容服务。
解决方案
解决此问题的方法非常直接：从 config_list 中的配置字典中移除 api_type 字段即可。AutoGen 会根据 api_base 的格式自动识别服务类型。
以下是修正后的代码示例：
from autogen import AssistantAgent, UserProxyAgent
# 修正后的 config_list，移除了 "api_type" 字段
config_list = [
{
"api_base": "http://localhost:1234/v1", # 确保指向本地LLM服务的V1兼容API端点
"api_key": "NULL" # 对于本地LLM，通常设置为"NULL"或任意字符串
}
]
llm_config = {'config_list': config_list}
assistant = AssistantAgent(
name="assistant",
llm_config = llm_config
)
user_proxy = UserProxyAgent(
name="user_proxy",
human_input_mode="NEVER",
max_consecutive_auto_reply=100,
)
task = """write a python method to output numbers 1 to 100"""
user_proxy.initiate_chat(
assistant,
message=task
)关键修正点： 移除了 config_list 中字典内的 "api_type": "open_ai" 行。
注意事项与最佳实践
- api_base 的格式： 确保 api_base 指向的本地 LLM 服务端点是符合 OpenAI API 规范的，通常这意味着 URL 应该以 /v1 结尾（例如 http://localhost:1234/v1）。LM Studio、Ollama 等工具通常会提供这样的兼容端点。
- api_key 的处理： 对于本地 LLM 服务，api_key 字段通常不是必需的，但 AutoGen 的 OpenAI 客户端可能仍要求其存在。在这种情况下，可以将其设置为 "NULL"、"sk-xxxx" 或任何非空字符串作为占位符。
- 版本兼容性： AutoGen 库的更新迭代较快，API 可能会发生变化。在遇到类似 TypeError 或配置问题时，建议查阅 AutoGen 的官方文档或 GitHub 仓库（尤其是 CHANGELOG 或 Roadmap 部分），以获取最新的配置要求和 API 规范。
- 调试本地 LLM 服务： 在运行 AutoGen 之前，请确保您的本地 LLM 服务（如 LM Studio）已正确启动，并且其监听的端口与 api_base 中指定的端口一致。可以通过在浏览器中访问 api_base 地址（例如 http://localhost:1234/v1/models）来验证服务是否正常运行。
总结
TypeError: create() got an unexpected keyword argument 'api_type' 错误是由于 AutoGen 库为保持与 OpenAI API 的兼容性而移除了 api_type 参数所致。用户只需从 config_list 中移除此参数，并确保 api_base 正确指向本地 LLM 服务的 OpenAI 兼容端点，即可顺利使用 AutoGen 与本地 LLM 进行交互。定期查阅官方文档是保持代码与库最新版本兼容性的重要习惯。
