在实际 AI 应用开发中我们经常面临一个选择是直接调用 OpenAI、Anthropic 等大模型的原生 API还是通过一个统一的网关来管理这些调用直接调用虽然简单但当你需要切换模型、管理密钥、处理限流或统一日志时代码会变得臃肿且难以维护。OpenRouter 作为一个聚合了众多前沿大模型如 GPT-4、Claude、Llama 等的 API 平台为开发者提供了统一的接口和灵活的模型路由能力。近期OpenRouter 推出了Ori Prime Agent这一智能体功能它不仅仅是简单的 API 转发更是一个可以理解上下文、管理工具调用并执行复杂任务的智能体框架。对于希望快速构建具备复杂推理和行动能力的 AI 应用的开发者来说这提供了一个新的、更集成的选项。本文将带你从零开始深入理解 OpenRouter 平台及其 Ori Prime Agent 智能体的核心概念。我们将完成从注册、获取 API Key到使用curl和bash脚本进行基础 API 调用再到利用 Ori Prime Agent 构建一个具备简单工具调用能力的智能体的全过程。文章会详细解释每一步背后的原理、关键参数的含义并提供完整的代码示例和配置片段。最后我们会探讨在实际开发中可能遇到的常见问题、排查方法以及将智能体集成到生产环境时的最佳实践。无论你是想快速体验不同大模型的能力还是计划开发一个复杂的 AI 智能体应用这篇文章都将为你提供一条清晰的实践路径。1. 理解 OpenRouter 与 Ori Prime Agent 的核心价值在深入代码之前我们需要厘清几个核心概念OpenRouter 平台是什么智能体Agent与传统 API 调用有何不同以及 Ori Prime Agent 在这个生态中扮演什么角色。1.1 OpenRouter大模型世界的“统一网关”OpenRouter 的核心定位是一个大模型 API 聚合与路由平台。你可以把它想象成一个智能的 API 网关背后连接了数十个主流的大语言模型提供商。统一接口无论你想调用 OpenAI 的 GPT-4、Anthropic 的 Claude还是 Meta 的 Llama你只需要学习 OpenRouter 的一套 API 规范。这极大地降低了多模型切换和测试的成本。模型发现与比价OpenRouter 提供了详细的模型列表、性能基准和实时价格。开发者可以根据任务需求如代码生成、创意写作和预算灵活选择最合适的模型。简化密钥管理你只需要保管一个 OpenRouter 的 API Key而无需为每个模型提供商单独申请和管理密钥。平台会帮你处理与下游供应商的认证和计费。内置优化平台可能提供请求优化、自动重试、频率限制管理等能力这些对于构建稳定的生产应用至关重要。对于开发者而言使用 OpenRouter 意味着将“模型接入”的复杂性外包可以更专注于应用逻辑本身。1.2 从 API 调用到智能体Agent传统的 API 调用是“一问一答”模式你发送一个提示Prompt模型返回一段文本完成Completion。这种模式适合内容生成、翻译、总结等单一任务。智能体Agent则代表了一种更高级的交互范式。一个智能体通常具备以下能力规划Planning将复杂目标分解为可执行的子任务。工具使用Tool Use能够调用外部工具或 API 来获取信息如搜索网络、查询数据库或执行操作如发送邮件、操作文件。记忆Memory在对话或任务执行过程中保持上下文并能从历史交互中学习。反思Reflection评估自身行动的结果并在必要时调整策略。因此智能体不再是简单的文本生成器而是一个可以自主或半自主完成复杂工作流的“虚拟助手”。1.3 Ori Prime AgentOpenRouter 的智能体解决方案Ori Prime Agent是 OpenRouter 推出的智能体框架。它不是一个独立的模型而是构建在 OpenRouter 平台之上的一层能力封装。它的价值在于降低开发门槛开发者无需从零开始设计智能体的规划、工具调用循环等复杂逻辑。Ori Prime Agent 提供了构建智能体所需的基础设施。与模型生态无缝集成你可以指定 OpenRouter 支持的任意一个模型如gpt-4o、claude-3.5-sonnet作为智能体的“大脑”推理核心。标准化工具调用它定义了一套标准化的方式让智能体能够声明、发现并调用开发者提供的工具函数。管理对话状态自动处理与智能体的多轮对话维护会话历史简化了状态管理。简单来说使用 Ori Prime Agent你可以快速将一个强大的大语言模型“升级”为一个能使用工具、处理多轮复杂对话的智能体。2. 环境准备与 OpenRouter 基础配置在开始构建智能体之前我们需要先打通与 OpenRouter 平台的基础连接。本节将涵盖账号注册、API Key 获取以及最基础的 API 调用测试。2.1 注册 OpenRouter 并获取 API Key访问官网打开 OpenRouter 官方网站。注册账号使用邮箱或第三方服务如 GitHub进行注册。获取 API Key登录后在控制台通常为https://openrouter.ai/keys找到 API Keys 管理页面。点击“Create Key”生成一个新的 API Key。请妥善保管此 Key它相当于你的密码。注意新注册的账号通常会有一定的免费额度用于测试具体额度请以平台当前政策为准。生产环境请关注计费方式并设置预算警报。2.2 验证 API 连通性使用curl进行测试在集成到代码前用curl命令测试是最快、最直接的方式。它能帮你确认网络、认证和基础请求格式是否正确。打开你的终端Terminal、Git Bash、PowerShell 等执行以下命令curl -X POST https://openrouter.ai/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer YOUR_OPENROUTER_API_KEY \ -H HTTP-Referer: https://your-site.com \ # 可选但推荐填写 -H X-Title: My Test App \ # 可选 -d { model: openai/gpt-3.5-turbo, messages: [ {role: user, content: Hello, what is the capital of France?} ] }请将YOUR_OPENROUTER_API_KEY替换为你刚才获取的真实 Key。命令参数解释-X POST: 指定 HTTP 方法为 POST。-H: 添加请求头Header。Authorization: Bearer ...: 这是认证核心必须正确。HTTP-Referer和X-Title: OpenRouter 要求用于标识应用来源有助于平台管理和监控。可以填写你的网站或应用名。-d: 指定请求体Body必须是 JSON 格式。model: 指定要使用的模型。OpenRouter 的模型标识符通常为提供商/模型名如openai/gpt-3.5-turbo。你可以在 OpenRouter 模型页面找到完整的列表。messages: 对话消息列表。每条消息包含roleuser,assistant,system和content。预期成功响应你会收到一个 JSON 格式的响应其中choices[0].message.content字段包含了模型的回答例如The capital of France is Paris.。常见问题与排查问题现象可能原因检查与解决401 UnauthorizedAPI Key 错误或未提供。1. 检查YOUR_OPENROUTER_API_KEY是否复制完整前后无空格。2. 确认 Key 是否有有效。400 Bad Request请求体 JSON 格式错误或缺少必填字段。1. 使用echo $... | python -m json.tool或在线工具验证 JSON 格式。2. 确保model字段的值是 OpenRouter 支持的合法模型标识符。404 Not Found请求 URL 错误。确认 URL 为https://openrouter.ai/api/v1/chat/completions。长时间无响应或超时网络问题或模型提供商响应慢。1. 检查网络连接。2. OpenRouter 或特定模型可能暂时不可用可稍后重试或查看平台状态页。429 Too Many Requests请求频率超限。免费额度可能已用完或请求速率过快。需等待或升级账户。2.3 准备一个简单的 Bash 测试脚本将curl命令写入脚本方便重复测试和参数化。创建一个名为test_openrouter.sh的文件#!/bin/bash # 配置变量 API_KEYYOUR_OPENROUTER_API_KEY # 请替换为你的真实 Key MODELopenai/gpt-3.5-turbo PROMPTHello, what is the capital of France? # 构建 JSON 数据 JSON_DATA$(cat EOF { model: $MODEL, messages: [ {role: user, content: $PROMPT} ] } EOF ) # 发送请求并格式化输出 echo Sending request to OpenRouter ($MODEL)... curl -s -X POST https://openrouter.ai/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $API_KEY \ -H HTTP-Referer: https://my-test-app.com \ -H X-Title: Bash Test Script \ -d $JSON_DATA | python3 -m json.tool # 使用 python 美化 JSON 输出 # 如果没有 python可以使用 jq | jq . # 如果都没有直接移除 | python3 -m json.tool 查看原始输出给脚本添加执行权限并运行chmod x test_openrouter.sh ./test_openrouter.sh这个脚本演示了如何将配置外置化并通过管道 (|) 使用python的json.tool模块或jq工具来美化输出这在调试时非常有用。3. 探索 Ori Prime Agent创建你的第一个智能体基础 API 调用成功后我们就可以进入 Ori Prime Agent 的世界。智能体的核心是让模型能够调用你定义的工具函数。我们将创建一个能查询当前时间的简单智能体。3.1 理解智能体的工作流程一个典型的 Ori Prime Agent 交互流程如下初始化会话向/agent/chat/completions端点发起请求开启一个与智能体的新会话。你可以指定使用的模型和系统提示System Prompt。定义工具在请求中通过tools参数提供一个工具列表。每个工具需要定义名称、描述、参数模式JSON Schema等。这相当于告诉智能体“你可以使用这些功能。”处理响应智能体背后的模型会分析你的用户输入User Message。如果它认为需要调用工具来回答问题它不会直接生成最终答案而是会在响应中返回一个或多个tool_calls。执行工具调用你的应用程序需要解析响应中的tool_calls根据name找到对应的本地函数并执行获取执行结果。提交工具结果你将工具执行的结果作为一条新的tool角色消息连同原始的assistant消息包含tool_calls一起再次发送给智能体端点。获取最终回答智能体在接收到工具执行结果后会综合所有信息生成面向用户的最终回答。这个过程可能循环多次直到智能体认为已经收集到足够信息来回答用户问题。3.2 创建一个具备时间查询工具的智能体我们将用curl和bash模拟这个完整的循环。为了清晰我们分步骤进行。步骤1定义工具并发起首次请求我们定义一个名为get_current_time的工具它不需要参数返回当前时间。创建脚本agent_step1.sh#!/bin/bash API_KEYYOUR_OPENROUTER_API_KEY MODELopenai/gpt-4o # 使用一个支持工具调用的强大模型 # 用户问题 USER_QUESTIONWhat time is it now? # 请求数据包含了工具定义 REQUEST_JSON$(cat EOF { model: $MODEL, messages: [ {role: user, content: $USER_QUESTION} ], tools: [ { type: function, function: { name: get_current_time, description: Get the current date and time., parameters: { type: object, properties: {}, required: [] } } } ], tool_choice: auto # 让模型自行决定是否调用工具 } EOF ) echo Step 1: Sending initial request with tool definition RESPONSE$(curl -s -X POST https://openrouter.ai/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $API_KEY \ -H HTTP-Referer: https://my-agent-app.com \ -H X-Title: Time Agent \ -d $REQUEST_JSON) echo $RESPONSE | python3 -m json.tool运行这个脚本。观察输出你应该会在choices[0].message中看到类似以下内容{ role: assistant, content: null, tool_calls: [ { id: call_abc123, type: function, function: { name: get_current_time, arguments: {} } } ] }注意content为null而tool_calls数组有内容。这表示模型决定调用get_current_time工具而不是直接回答。步骤2解析工具调用并执行本地函数我们需要从响应中提取tool_call_id和function name然后模拟执行本地函数获取当前时间。创建脚本agent_step2.sh它读取上一步的响应这里我们简化直接模拟#!/bin/bash # 模拟从 Step1 响应中获取的数据 TOOL_CALL_IDcall_simulated_123 TOOL_NAMEget_current_time echo Step 2: Executing tool $TOOL_NAME # 模拟工具执行获取当前时间 TOOL_RESULT$(date -Iseconds) # ISO 8601 格式时间例如 2023-10-27T10:30:0008:00 # 对于 macOS如果 date 不支持 -Iseconds可以使用TOOL_RESULT$(date %Y-%m-%dT%H:%M:%S%z) echo Tool executed. Result: $TOOL_RESULT # 构建包含工具执行结果的新消息列表 # 这个消息列表需要包含原始的用户消息、上一步助手的消息含tool_calls、工具执行结果消息 MESSAGES_FOR_NEXT_REQUEST$(cat EOF [ {role: user, content: What time is it now?}, { role: assistant, content: null, tool_calls: [ { id: $TOOL_CALL_ID, type: function, function: { name: $TOOL_NAME, arguments: {} } } ] }, { role: tool, content: $TOOL_RESULT, tool_call_id: $TOOL_CALL_ID } ] EOF ) echo Prepared messages for next request echo $MESSAGES_FOR_NEXT_REQUEST | python3 -m json.tool步骤3提交工具结果并获取智能体最终回答现在我们将包含工具执行结果的消息列表发送给智能体让它生成最终回答。创建脚本agent_step3.sh#!/bin/bash API_KEYYOUR_OPENROUTER_API_KEY MODELopenai/gpt-4o # 使用上一步构建的消息列表 MESSAGES[ {role: user, content: What time is it now?}, { role: assistant, content: null, tool_calls: [ { id: call_simulated_123, type: function, function: { name: get_current_time, arguments: {} } } ] }, { role: tool, content: 2023-10-27T10:30:0008:00, tool_call_id: call_simulated_123 } ] REQUEST_JSON$(cat EOF { model: $MODEL, messages: $MESSAGES, tools: [ { type: function, function: { name: get_current_time, description: Get the current date and time., parameters: { type: object, properties: {}, required: [] } } } ] // 注意这里通常不需要再传 tool_choice因为对话历史中已经包含了工具调用 } EOF ) echo Step 3: Sending tool result back to agent FINAL_RESPONSE$(curl -s -X POST https://openrouter.ai/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $API_KEY \ -H HTTP-Referer: https://my-agent-app.com \ -H X-Title: Time Agent \ -d $REQUEST_JSON) echo Final Answer from Agent echo $FINAL_RESPONSE | python3 -m json.tool运行agent_step3.sh你应该会收到一个content字段不为空的响应其中包含了模型根据当前时间生成的友好回答例如“The current time is 10:30 AM on October 27, 2023 (UTC8).”。通过这三个步骤我们手动模拟了 Ori Prime Agent 智能体与工具调用的完整循环。在实际的应用程序中你需要编写代码来自动化地解析tool_calls、映射到本地函数、执行并管理整个对话状态。4. 构建一个完整的 Bash 脚本智能体示例将上述分散的步骤整合到一个脚本中并增加错误处理和更复杂的工具例如一个能做加法的工具可以让我们更清晰地看到智能体的工作全貌。创建simple_agent.sh脚本#!/bin/bash API_KEYYOUR_OPENROUTER_API_KEY MODELopenai/gpt-4o SESSION_MESSAGES_FILE/tmp/agent_messages.json # 用于持久化会话消息 # 初始化消息历史 init_messages() { local user_input$1 cat $SESSION_MESSAGES_FILE EOF [ {role: system, content: You are a helpful assistant with access to tools. Use them when needed.}, {role: user, content: $user_input} ] EOF } # 定义可用的工具函数 # 工具1: 获取当前时间 tool_get_current_time() { date -Iseconds 2/dev/null || date %Y-%m-%dT%H:%M:%S%z } # 工具2: 计算两个数的和 tool_calculator_add() { local args$1 # 从JSON字符串中解析参数这里简单用 grep 和 cut 模拟生产环境应用 jq local num1$(echo $args | grep -o num1:[^,}]* | cut -d: -f2 | tr -d ) local num2$(echo $args | grep -o num2:[^,}]* | cut -d: -f2 | tr -d ) if [[ -n $num1 -n $num2 ]]; then echo $((num1 num2)) else echo Error: Missing or invalid arguments for addition. fi } # 发送请求到 OpenRouter send_request() { local messages$(cat $SESSION_MESSAGES_FILE) local tools_json[ { type: function, function: { name: get_current_time, description: Get the current date and time in ISO format., parameters: {type: object, properties: {}, required: []} } }, { type: function, function: { name: calculator_add, description: Add two numbers., parameters: { type: object, properties: { num1: {type: number, description: The first number.}, num2: {type: number, description: The second number.} }, required: [num1, num2] } } } ] local request_json$(cat EOF { model: $MODEL, messages: $messages, tools: $tools_json, tool_choice: auto } EOF ) curl -s -X POST https://openrouter.ai/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $API_KEY \ -H HTTP-Referer: https://my-bash-agent.com \ -H X-Title: Bash Simple Agent \ -d $request_json } # 处理响应执行工具调用并更新消息历史 process_response() { local response_json$1 # 使用 jq 解析响应确保已安装 jq: sudo apt-get install jq 或 brew install jq if ! command -v jq /dev/null; then echo Error: jq is required but not installed. Please install jq. exit 1 fi local assistant_message$(echo $response_json | jq -c .choices[0].message) local role$(echo $assistant_message | jq -r .role) local content$(echo $assistant_message | jq -r .content // empty) local tool_calls$(echo $assistant_message | jq -c .tool_calls // []) # 将助手的消息追加到历史 jq --argjson msg $assistant_message . [$msg] $SESSION_MESSAGES_FILE ${SESSION_MESSAGES_FILE}.tmp mv ${SESSION_MESSAGES_FILE}.tmp $SESSION_MESSAGES_FILE # 如果有最终内容输出并结束 if [[ -n $content $content ! null ]]; then echo -e \n Agent Final Answer echo $content return 0 # 结束循环 fi # 处理工具调用 local tool_calls_count$(echo $tool_calls | jq length) if [[ $tool_calls_count -gt 0 ]]; then echo Agent is calling $tool_calls_count tool(s) for ((i0; itool_calls_count; i)); do local tool_call$(echo $tool_calls | jq -c .[$i]) local tool_call_id$(echo $tool_call | jq -r .id) local tool_name$(echo $tool_call | jq -r .function.name) local tool_args$(echo $tool_call | jq -r .function.arguments) echo Executing: $tool_name($tool_args) local tool_result case $tool_name in get_current_time) tool_result$(tool_get_current_time) ;; calculator_add) tool_result$(tool_calculator_add $tool_args) ;; *) tool_resultError: Unknown tool $tool_name. ;; esac echo Result: $tool_result # 将工具执行结果作为一条新消息追加 local tool_message$(jq -n \ --arg role tool \ --arg content $tool_result \ --arg tool_call_id $tool_call_id \ {role: $role, content: $content, tool_call_id: $tool_call_id}) jq --argjson msg $tool_message . [$msg] $SESSION_MESSAGES_FILE ${SESSION_MESSAGES_FILE}.tmp mv ${SESSION_MESSAGES_FILE}.tmp $SESSION_MESSAGES_FILE done return 1 # 需要继续循环 else echo Warning: No content and no tool_calls in response. return 0 fi } # 主循环 main() { if [[ $# -eq 0 ]]; then echo Usage: $0 \Your question or instruction\ exit 1 fi local user_input$1 init_messages $user_input local max_iterations5 # 防止无限循环 local iteration0 while [[ $iteration -lt $max_iterations ]]; do ((iteration)) echo -e \n--- Iteration $iteration --- response$(send_request) if [[ -z $response ]]; then echo Error: No response from API. break fi # 检查 API 错误 if echo $response | jq -e .error /dev/null 21; then echo API Error: echo $response | jq .error break fi process_response $response local status$? if [[ $status -eq 0 ]]; then break # 收到最终回答退出循环 fi done if [[ $iteration -ge $max_iterations ]]; then echo Reached maximum iterations ($max_iterations). Stopping. fi } main $脚本使用方式将YOUR_OPENROUTER_API_KEY替换为你的真实 Key。确保系统已安装jq工具用于解析 JSON。安装命令Ubuntu/Debian:sudo apt-get install jq, macOS:brew install jq。给脚本执行权限chmod x simple_agent.sh。运行脚本并提问./simple_agent.sh What is the sum of 15 and 27?./simple_agent.sh What time is it now, and also tell me the sum of 100 and 200?这个脚本实现了一个简单的智能体循环它维护一个消息历史文件。定义了两个工具get_current_time和calculator_add。自动解析模型的响应判断是直接回答还是调用工具。如果调用工具则执行对应的本地函数并将结果追加到消息历史。循环发送请求直到模型返回最终文本内容或达到最大迭代次数。5. 常见问题排查与生产环境建议将 OpenRouter 和 Ori Prime Agent 用于实际项目时你会遇到比示例更复杂的情况。以下是关键问题的排查思路和生产级建议。5.1 常见错误与排查清单问题现象可能原因排查步骤与解决方案工具调用未被触发1. 模型不支持工具调用。2. 工具描述不够清晰。3. 用户问题不需要工具即可回答。4.tool_choice参数设置为none。1.确认模型确保使用的模型如gpt-4o,claude-3.5-sonnet支持函数调用/工具调用功能。2.优化工具描述在function.description中清晰说明工具的用途和适用场景。3.检查tool_choice设置为auto默认或{type: function, function: {name: xxx}}来强制调用。4.在系统提示中引导在system消息中明确告诉模型“你可以使用可用的工具”。工具调用参数解析错误1. 本地函数期望的参数与 JSON Schema 定义不匹配。2. 模型生成的argumentsJSON 字符串格式错误。1.严格校验 Schema确保function.parameters定义的type,properties,required准确无误。2.增强本地解析的鲁棒性使用jq或编程语言的 JSON 库来解析arguments而不是简单的字符串匹配。添加错误处理对解析失败的情况返回清晰错误信息给模型。会话状态管理混乱1. 消息历史messages数组在多次请求间未正确维护。2. 丢失了tool角色消息或tool_call_id不匹配。1.持久化消息列表在服务端使用会话 ID 关联存储完整的messages数组。每次请求都携带完整的历史。2.遵循消息顺序顺序必须是用户消息 - 助手消息含 tool_calls - 工具消息对应每个 tool_call- 助手最终消息。不能遗漏或错序。3.匹配tool_call_id确保tool消息中的tool_call_id与之前assistant消息中tool_calls[i].id完全一致。响应缓慢或超时1. 网络延迟。2. 模型负载高。3. 智能体进行了多轮复杂的工具调用循环。1.设置合理超时在客户端和服务器端设置 HTTP 请求超时如 30-60秒。2.监控与降级监控 API 延迟必要时切换到更快的模型或提供 fallback 回答。3.限制迭代次数如示例所示设置max_iterations如 5-10 次防止无限循环。计费超出预期1. 智能体循环导致多次 API 调用。2. 未使用流式响应处理长内容成本高。1.理解计费单位OpenRouter 按输入/输出 Token 计费。工具调用会增加请求的 Token 数量。2.实施使用限制为用户或会话设置 Token 或调用次数上限。3.考虑流式响应对于长文本生成使用stream: true可以边生成边返回但需要更复杂的客户端处理。5.2 生产环境最佳实践密钥与配置管理绝不硬编码将 API Key 存储在环境变量或安全的配置管理服务中。使用不同密钥为开发、测试、生产环境使用不同的 OpenRouter API Key并设置不同的额度限制。# 示例从环境变量读取 API_KEY${OPENROUTER_API_KEY} if [[ -z $API_KEY ]]; then echo Error: OPENROUTER_API_KEY environment variable is not set. exit 1 fi错误处理与重试网络错误实现指数退避重试机制。API 错误正确处理429限流、5xx服务器错误等状态码。工具执行错误当工具调用失败时将清晰的错误信息作为tool消息的内容返回给模型让它有机会调整或告知用户。日志与监控记录完整交互记录每个请求的模型、消息、工具调用、Token 使用量和响应时间。这对调试和成本分析至关重要。设置告警对错误率、延迟突增、异常高的 Token 消耗设置监控告警。工具设计的注意事项幂等性工具函数应尽可能设计为幂等的即多次调用产生相同结果避免因重试导致副作用。安全性工具可能执行敏感操作如数据库查询、发送通知。必须对输入进行严格的验证和授权检查防止模型被诱导执行恶意操作。超时与资源限制为工具执行设置超时防止长时间运行阻塞智能体循环。性能优化缓存对于耗时的工具调用如复杂查询、第三方 API考虑缓存结果。并行工具调用如果模型返回多个独立的tool_calls且工具之间无依赖可以在客户端并行执行以提高效率。6. 扩展方向与下一步学习掌握了 OpenRouter 基础 API 和 Ori Prime Agent 的简单工具调用后你可以向以下几个方向深入构建更强大的 AI 应用。集成更复杂的工具网络搜索让智能体能获取实时信息。数据库操作允许智能体查询或更新业务数据需极度谨慎的权限控制。外部 API连接企业内部系统或其他 SaaS 服务。代码执行在沙箱环境中运行代码风险极高需严格隔离。使用 SDK 替代原始 HTTP 调用OpenRouter API 兼容 OpenAI SDK。你可以直接使用openaiPython 库只需修改base_url和api_key。from openai import OpenAI client OpenAI( base_urlhttps://openrouter.ai/api/v1, api_keyYOUR_OPENROUTER_API_KEY, ) response client.chat.completions.create( modelopenai/gpt-4o, messages[...], tools[...] )使用 SDK 可以简化对话状态管理、工具调用循环的处理。探索更高级的智能体框架LangChain / LangGraph提供了更成熟的智能体、工具链、记忆管理等抽象。AutoGen支持多智能体协作对话。Dify, Coze这些平台提供了可视化的工作流编排和智能体构建能力可以降低开发门槛。你可以将 OpenRouter 作为这些平台的后端模型提供商之一。深入优化提示工程Prompt Engineering精心设计system提示词明确智能体的角色、能力和约束。在工具描述中提供清晰的示例引导模型更准确地调用工具。通过少样本学习Few-shot Learning在消息历史中提供成功的交互示例。OpenRouter 的 Ori Prime Agent 功能为开发者提供了一个快速启动智能体开发的平台。从简单的curl测试开始逐步构建能处理复杂工作流的智能体是理解并掌握这一强大范式的最佳路径。始终记住强大的能力也意味着更大的责任在生产环境中部署智能体时安全、可控和可观测性必须是首要考虑的因素。