用途 该技能提供对 OpenAI API 的直接访问，用于生成文本补全、处理函数调用、管理助手以及创建嵌入等任务。它专为 AI 智能体设计，以便将 OpenAI 的能力集成到工作流中。
适用场景 当你需要动态文本生成（例如用于聊天机器人）、用于语义搜索的嵌入，或用于工具集成的函数调用时，可使用此技能。它适用于需要实时 AI 响应的场景，如代码生成、内容摘要或数据分析。对于简单任务应避免使用；仅在 OpenAI 模型优于本地替代方案的复杂 AI 驱动操作中保留使用。
主要能力 文本补全：使用 /completions 端点，配合 text-davinci-003 等模型进行基于提示的基础生成。 聊天补全：利用 /chat/completions 实现对话式 AI，支持基于角色的消息和工具。 函数调用：通过在请求体中定义函数，在 /chat/completions 中启用工具，实现动态 API 交互。 助手：通过 /assistants 端点管理自定义助手，用于带有工具和文件的持久化 AI 智能体。 嵌入：通过 /embeddings 生成向量表示，用于相似性搜索等应用。 微调：访问 /fine-tunes 以自定义模型，但这需要特定输入格式，如 JSONL 文件。
使用方式 始终通过环境变量设置 API 密钥：export OPENAI_API_KEY=your_api_key。向基础 URL https://api.openai.com/v1/ 发起请求。对于 CLI 或脚本使用，可使用 curl 或 OpenAI 的 SDK 等工具。使用 JSON 负载构建请求，包含 model（例如 gpt-3.5-turbo）和 max_tokens（例如 150）等参数。通过实现带指数退避的重试逻辑来处理速率限制。要使用函数调用，请在请求中包含 "tools" 数组，并检查响应中的 "tool_calls"。
常用命令/API 通过 HTTP 请求或 OpenAI SDK 进行交互。对于身份验证，包含请求头：Authorization: Bearer $OPENAI_API_KEY。关键端点：
文本补全：向 /completions 发送 POST 请求，请求体为 {"model": "text-davinci-003", "prompt": "Hello world", "max_tokens": 50}。 示例片段：
curl https://api.openai.com/v1/completions
-H "Authorization: Bearer $OPENAI_API_KEY"
-H "Content-Type: application/json"
-d '{"model": "text-davinci-003", "prompt": "Explain AI"}'
聊天补全：向 /chat/completions 发送 POST 请求，请求体为 {"model": "gpt-3.5-turbo", "messages": [{"role": "user", "content": "Hello"}], "tools": [...]}。 示例片段：
curl https://api.openai.com/v1/chat/completions
-H "Authorization: Bearer $OPENAI_API_KEY"
-d '{"model": "gpt-3.5-turbo", "messages": [{"role": "user", "content": "Summarize this: AI is changing the world"}]}'
嵌入：向 /embeddings 发送 POST 请求，请求体为 {"model": "text-embedding-ada-002", "input": "Your text here"}。 示例：在代码中使用：response = openai.Embedding.create(model="text-embedding-ada-002", input="Hello")
配置格式：请求通常使用 JSON，如 {"temperature": 0.7, "top_p": 1} 来控制输出随机性。
集成说明 通过在你的语言中导入 OpenAI SDK 进行集成（例如 Python 使用 pip install openai）。设置事件驱动模式，例如在用户输入时触发补全。对于函数调用，将工具定义为字典列表（例如 {"type": "function", "function": {"name": "get_weather", "parameters": {"location": "string"}}}）。通过标准化响应格式，确保与其他 AI API 的兼容性。使用 webhooks 让助手处理异步事件。使用模拟服务器测试集成，以避免真实 API 成本。
错误处理 常见错误包括 429（超出速率限制）、401（未授权）和 400（错误请求）。检查响应状态码，并从 JSON 正文中解析错误消息（例如 {"error": {"message": "Invalid model", "type": "invalid_request_error"}}）。对瞬时错误实现重试逻辑：使用带 time.sleep() 的循环进行延迟。对于身份验证失败，验证 $OPENAI_API_KEY 已设置且未过期。记录包含错误代码和消息等详细信息的错误，然后回退到默认响应或替代技能。
图谱关系 连接到集群：ai-apis 相关标签：ai-apis、api 潜在链接：与同一集群中的技能集成，例如其他 AI API 以组合工作流；依赖身份验证服务进行密钥管理。