{"id":103994,"date":"2026-09-11T16:25:02","date_gmt":"2026-09-11T08:25:02","guid":{"rendered":"https:\/\/www.wsisp.com\/helps\/103994.html"},"modified":"2026-09-11T16:25:02","modified_gmt":"2026-09-11T08:25:02","slug":"%e7%ac%ac-30-%e7%ab%a0%e3%80%8apython-sdk-openai-%e5%85%bc%e5%ae%b9-api-%e6%9c%80%e4%bd%b3%e5%ae%9e%e8%b7%b5%e3%80%8b%c2%b7-nanobot-sdk-openai-%e5%85%bc%e5%ae%b9-api-%e6%ba%90%e7%a0%81%e8%a7%a3","status":"publish","type":"post","link":"https:\/\/www.wsisp.com\/helps\/103994.html","title":{"rendered":"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co"},"content":{"rendered":"

\u672c\u7ae0\u662f\u4e13\u680f\u6536\u5c3e\u7bc7：\u89e3\u6790 nanobot\/nanobot.py \u7684 Nanobot \u95e8\u9762\u7c7b，\u4ee5\u53ca nanobot\/api\/server.py \u66b4\u9732\u7684 OpenAI \u517c\u5bb9 HTTP API\u3002\u8bfb\u5b8c\u672c\u7ae0\u4f60\u80fd\u7528"\u4efb\u610f\u80fd\u8c03 OpenAI SDK \u7684\u5ba2\u6237\u7aef"\u8c03\u7528\u4f60\u81ea\u5df1\u7684 nanobot \u5b9e\u4f8b\u3002<\/p>\n

1. \u6574\u4f53\u5b9a\u4f4d：\u4e3a\u4ec0\u4e48\u9700\u8981 SDK + OpenAI \u517c\u5bb9 API<\/h3>\n

\u4e24\u79cd\u96c6\u6210\u573a\u666f：<\/p>\n\n\u573a\u666f\u5165\u53e3\u7528\u9014<\/tr>\n\n\n\n
Python \u96c6\u6210（\u5728\u811a\u672c \/ Notebook \u4e2d\u8c03\u7528 Agent）<\/td>\nnanobot.nanobot.Nanobot<\/td>\n\u50cf openai.OpenAI() \u90a3\u6837 Nanobot.from_config().run(…)<\/td>\n<\/tr>\n
HTTP \u96c6\u6210（\u4efb\u4f55\u8bed\u8a00\u5ba2\u6237\u7aef）<\/td>\nnanobot.api.server \u7684 \/v1\/chat\/completions<\/td>\ncurl \/ fetch \/ \u4efb\u4f55 OpenAI SDK<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\u4e24\u8005\u90fd\u57fa\u4e8e\u540c\u4e00\u4e2a AgentLoop（\u7b2c 10 \u7ae0），\u53ea\u662f\u5165\u53e3\u4e0d\u540c\u3002\u672c\u7ae0\u7ed9"\u5916\u90e8\u96c6\u6210\u8005"\u4e00\u4e2a\u5b8c\u6574\u89c6\u56fe\u3002<\/p>\n

2. \u6838\u5fc3\u6570\u636e\u7ed3\u6784：Nanobot \u95e8\u9762<\/h3>\n

2.1 \u7c7b\u7b7e\u540d（\u5df2 Read \u6838\u5bf9）<\/h4>\n

# \u6765\u6e90：nanobot\/nanobot.py L64-L80（\u7b80\u5316）<\/span>
\nclass<\/span> Nanobot<\/span>:<\/span>
\n """Programmatic facade for running the nanobot agent.<\/p>\n

Usage::<\/p>\n

bot = Nanobot.from_config()
\n result = await bot.run("Summarize this repo", hooks=[MyHook()])
\n print(result.content)
\n """<\/span><\/p>\n

def<\/span> __init__<\/span>(<\/span>self,<\/span> loop:<\/span> AgentLoop,<\/span> *<\/span>,<\/span> config:<\/span> Config |<\/span> None<\/span> =<\/span> None<\/span>)<\/span> –<\/span>><\/span> None<\/span>:<\/span>
\n self.<\/span>_loop =<\/span> loop
\n self.<\/span>_config =<\/span> config
\n self.<\/span>sessions =<\/span> SessionClient(<\/span>loop)<\/span>
\n self.<\/span>memory =<\/span> MemoryClient(<\/span>loop)<\/span>
\n self.<\/span>runtime =<\/span> RuntimeClient(<\/span>loop)<\/span><\/p>\n

2.2 \u5b57\u6bb5\u8868<\/h4>\n\n\u5b57\u6bb5\u7c7b\u578b\u8bf4\u660e<\/tr>\n\n\n\n\n\n\n
_loop<\/td>\nAgentLoop<\/td>\n\u6ce8\u5165\u7684\u6838\u5fc3 loop<\/td>\n<\/tr>\n
_config<\/td>\nConfig | None<\/td>\n\u53ef\u9009\u914d\u7f6e\u5f15\u7528<\/td>\n<\/tr>\n
sessions<\/td>\nSessionClient<\/td>\n\u4f1a\u8bdd\u7ba1\u7406\u5ba2\u6237\u7aef<\/td>\n<\/tr>\n
memory<\/td>\nMemoryClient<\/td>\n\u8bb0\u5fc6\u7ba1\u7406\u5ba2\u6237\u7aef<\/td>\n<\/tr>\n
runtime<\/td>\nRuntimeClient<\/td>\n\u8fd0\u884c\u65f6\u63a7\u5236\u5ba2\u6237\u7aef（MCP reload \u7b49）<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

2.3 from_config \u7c7b\u65b9\u6cd5<\/h4>\n

# \u6765\u6e90：nanobot\/nanobot.py L81-L100（\u7b80\u5316）<\/span>
\n@classmethod<\/span>
\ndef<\/span> from_config<\/span>(<\/span>
\n cls,<\/span>
\n config_path:<\/span> str<\/span> |<\/span> Path |<\/span> None<\/span> =<\/span> None<\/span>,<\/span>
\n *<\/span>,<\/span>
\n workspace:<\/span> str<\/span> |<\/span> Path |<\/span> None<\/span> =<\/span> None<\/span>,<\/span>
\n model:<\/span> str<\/span> |<\/span> None<\/span> =<\/span> None<\/span>,<\/span>
\n model_preset:<\/span> str<\/span> |<\/span> None<\/span> =<\/span> None<\/span>,<\/span>
\n)<\/span> –<\/span>><\/span> Nanobot:<\/span>
\n """Create a Nanobot instance from a config file.<\/p>\n

Args:
\n config_path: Path to `config.json`. Defaults to
\n `~\/.nanobot\/config.json`.
\n workspace: Override the workspace directory from config.
\n model: Override the instance default model.
\n model_preset: Override the instance default model preset.
\n """<\/span>
\n from<\/span> nanobot.<\/span>config.<\/span>loader import<\/span> load_config,<\/span> resolve_config_env_vars
\n # … \u5b9e\u9645\u6784\u9020\u903b\u8f91<\/span><\/p>\n

2.4 __all__ \u5bfc\u51fa（\u5df2 Read \u6838\u5bf9）<\/h4>\n

# \u6765\u6e90：nanobot\/nanobot.py L42-L61<\/span>
\n__all__ =<\/span> [<\/span>
\n "Nanobot"<\/span>,<\/span>
\n "RunResult"<\/span>,<\/span>
\n "RunStream"<\/span>,<\/span>
\n "SessionInfo"<\/span>,<\/span>
\n "SessionSnapshot"<\/span>,<\/span>
\n "STREAM_EVENT_REASONING_COMPLETED"<\/span>,<\/span>
\n "STREAM_EVENT_REASONING_DELTA"<\/span>,<\/span>
\n "STREAM_EVENT_RUN_COMPLETED"<\/span>,<\/span>
\n "STREAM_EVENT_RUN_FAILED"<\/span>,<\/span>
\n "STREAM_EVENT_RUN_STARTED"<\/span>,<\/span>
\n "STREAM_EVENT_TEXT_COMPLETED"<\/span>,<\/span>
\n "STREAM_EVENT_TEXT_DELTA"<\/span>,<\/span>
\n "STREAM_EVENT_TOOL_COMPLETED"<\/span>,<\/span>
\n "STREAM_EVENT_TOOL_FAILED"<\/span>,<\/span>
\n "STREAM_EVENT_TOOL_STARTED"<\/span>,<\/span>
\n "STREAM_EVENT_TYPES"<\/span>,<\/span>
\n "StreamEvent"<\/span>,<\/span>
\n "StreamEventType"<\/span>,<\/span>
\n]<\/span><\/p>\n

STREAM_EVENT_* \u5e38\u91cf\u662f\u6d41\u5f0f\u56de\u8c03\u65f6 event["type"] \u7684\u53d6\u503c，\u914d\u5408 use_nanobot_stream() \u7b49\u524d\u7aef hook \u4f7f\u7528（webui\/src\/hooks\/useNanobotStream.ts）\u3002<\/p>\n

3. \u6d41\u5f0f\u4e8b\u4ef6\u534f\u8bae<\/h3>\n

nanobot.sdk.streaming（sdk\/streaming.py）\u5b9a\u4e49\u4e86 SDK \u4e0e AgentLoop \u7684\u6d41\u5f0f\u4e8b\u4ef6：<\/p>\n

# \u4e8b\u4ef6\u7c7b\u578b\u5e38\u91cf（\u6765\u6e90 nanobot\/sdk\/types.py）<\/span>
\nSTREAM_EVENT_REASONING_DELTA =<\/span> "reasoning_delta"<\/span> # \u6a21\u578b\u601d\u7ef4\u94fe\u7247\u6bb5<\/span>
\nSTREAM_EVENT_REASONING_COMPLETED =<\/span> "reasoning_completed"<\/span>
\nSTREAM_EVENT_TEXT_DELTA =<\/span> "text_delta"<\/span> # \u56de\u590d\u6587\u672c\u7247\u6bb5<\/span>
\nSTREAM_EVENT_TEXT_COMPLETED =<\/span> "text_completed"<\/span>
\nSTREAM_EVENT_TOOL_STARTED =<\/span> "tool_started"<\/span> # \u5de5\u5177\u8c03\u7528\u5f00\u59cb<\/span>
\nSTREAM_EVENT_TOOL_COMPLETED =<\/span> "tool_completed"<\/span>
\nSTREAM_EVENT_TOOL_FAILED =<\/span> "tool_failed"<\/span>
\nSTREAM_EVENT_RUN_STARTED =<\/span> "run_started"<\/span> # \u6574\u8f6e\u5f00\u59cb<\/span>
\nSTREAM_EVENT_RUN_COMPLETED =<\/span> "run_completed"<\/span> # \u6574\u8f6e\u7ed3\u675f<\/span>
\nSTREAM_EVENT_RUN_FAILED =<\/span> "run_failed"<\/span><\/p>\n

WebUI \u5ba2\u6237\u7aef\u6309\u8fd9\u4e9b\u4e8b\u4ef6\u7c7b\u578b\u6e32\u67d3"\u601d\u7ef4\u94fe \u2192 \u5de5\u5177\u8c03\u7528 \u2192 \u6587\u672c"\u7684\u5206\u5c42\u65f6\u95f4\u7ebf\u3002<\/p>\n

4. OpenAI \u517c\u5bb9 HTTP API<\/h3>\n

4.1 \u5165\u53e3<\/h4>\n

nanobot api # \u542f\u52a8 HTTP \u670d\u52a1（\u9ed8\u8ba4 :8765）<\/span>
\nnanobot gateway # \u542f\u52a8 gateway（\u5305\u542b API + WebUI）<\/span><\/p>\n

4.2 \u7aef\u70b9\u901f\u67e5<\/h4>\n\n\u7aef\u70b9\u65b9\u6cd5\u8bf4\u660e<\/tr>\n\n\n\n\n\n\n\n
\/v1\/models<\/td>\nGET<\/td>\n\u5217\u51fa\u53ef\u7528\u6a21\u578b<\/td>\n<\/tr>\n
\/v1\/chat\/completions<\/td>\nPOST<\/td>\nOpenAI \u517c\u5bb9 chat<\/td>\n<\/tr>\n
\/v1\/audio\/transcriptions<\/td>\nPOST<\/td>\nOpenAI \u517c\u5bb9 Whisper \u8f6c\u5f55<\/td>\n<\/tr>\n
\/v1\/images\/generations<\/td>\nPOST<\/td>\nOpenAI \u517c\u5bb9\u56fe\u50cf\u751f\u6210<\/td>\n<\/tr>\n
\/health<\/td>\nGET<\/td>\n\u5065\u5eb7\u68c0\u67e5（gateway \u6a21\u5f0f）<\/td>\n<\/tr>\n
\/ws<\/td>\nGET（upgrade）<\/td>\nWebSocket（WebUI \/ \u81ea\u7814\u901a\u9053）<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

4.3 \u5ba2\u6237\u7aef\u8c03\u7528\u793a\u4f8b<\/h4>\n

curl<\/span> http:\/\/localhost:8765\/v1\/chat\/completions \\\\<\/span>
\n -H<\/span> "Content-Type: application\/json"<\/span> \\\\<\/span>
\n -d<\/span> '{
\n "model": "claude-sonnet-4.5",
\n "messages": [{"role": "user", "content": "\u7528\u4e00\u53e5\u8bdd\u4ecb\u7ecd nanobot"}],
\n "stream": true
\n }'<\/span><\/p>\n

# Python \u5ba2\u6237\u7aef（\u4efb\u4f55 OpenAI SDK）<\/span>
\nfrom<\/span> openai import<\/span> OpenAI
\nclient =<\/span> OpenAI(<\/span>base_url=<\/span>"http: # localhost:8765\/v1"<\/span>,<\/span> api_key=<\/span>"not-needed"<\/span>)<\/span>
\nresp =<\/span> client.<\/span>chat.<\/span>completions.<\/span>create(<\/span>
\n model=<\/span>"claude-sonnet-4.5"<\/span>,<\/span>
\n messages=<\/span>[<\/span>{<\/span>"role"<\/span>:<\/span> "user"<\/span>,<\/span> "content"<\/span>:<\/span> "Hello"<\/span>}<\/span>]<\/span>,<\/span>
\n)<\/span>
\nprint<\/span>(<\/span>resp.<\/span>choices[<\/span>0<\/span>]<\/span>.<\/span>message.<\/span>content)<\/span><\/p>\n

5. \u5173\u952e\u6e90\u7801\u6458\u5f55<\/h3>\n

5.1 Nanobot.run \u5165\u53e3<\/h4>\n

# \u7b80\u5316\u793a\u610f（\u5177\u4f53\u884c\u53f7\u89c1 nanobot\/nanobot.py）<\/span>
\nasync<\/span> def<\/span> run<\/span>(<\/span>
\n self,<\/span>
\n message:<\/span> str<\/span>,<\/span>
\n *<\/span>,<\/span>
\n session_key:<\/span> str<\/span> |<\/span> None<\/span> =<\/span> None<\/span>,<\/span>
\n hooks:<\/span> list<\/span>[<\/span>AgentHook]<\/span> |<\/span> None<\/span> =<\/span> None<\/span>,<\/span>
\n stream:<\/span> bool<\/span> =<\/span> False<\/span>,<\/span>
\n)<\/span> –<\/span>><\/span> RunResult |<\/span> RunStream:<\/span>
\n """Run a single agent turn.<\/p>\n

Args:
\n message: User message content.
\n session_key: Optional override for session key (default: derive from message).
\n hooks: Per-turn hooks (pre_turn \/ post_turn).
\n stream: If True, return RunStream for incremental consumption.<\/p>\n

Returns:
\n RunResult on non-streaming, RunStream on streaming.
\n """<\/span>
\n .<\/span>.<\/span>.<\/span><\/p>\n

5.2 api\/server.py \u8def\u7531（\u7b80\u5316）<\/h4>\n

# \u7b80\u5316\u793a\u610f（\u5177\u4f53\u884c\u53f7\u89c1 nanobot\/api\/server.py）<\/span>
\nfrom<\/span> fastapi import<\/span> FastAPI,<\/span> Request
\nfrom<\/span> nanobot.<\/span>nanobot import<\/span> Nanobot<\/p>\n

app =<\/span> FastAPI(<\/span>)<\/span>
\n_bot:<\/span> Nanobot |<\/span> None<\/span> =<\/span> None<\/span><\/p>\n

@app.<\/span>post<\/span>(<\/span>"\/v1\/chat\/completions"<\/span>)<\/span>
\nasync<\/span> def<\/span> chat_completions<\/span>(<\/span>request:<\/span> Request)<\/span>:<\/span>
\n body =<\/span> await<\/span> request.<\/span>json(<\/span>)<\/span>
\n # 1. \u6821\u9a8c model \/ messages<\/span>
\n # 2. \u8c03\u7528 Nanobot.run(message=…, stream=body.get("stream", False))<\/span>
\n # 3. \u628a RunResult \u8f6c\u6362\u4e3a OpenAI ChatCompletion \u683c\u5f0f<\/span>
\n .<\/span>.<\/span>.<\/span><\/p>\n

6. \u4e3a\u4ec0\u4e48\u8fd9\u6837\u8bbe\u8ba1：5 \u4e2a\u6838\u5fc3\u51b3\u7b56<\/h3>\n

\u51b3\u7b56 1 \u00b7 \u4e3a\u4ec0\u4e48 SDK \u95e8\u9762\u53eb Nanobot \u800c\u975e Client？<\/h4>\n

\u4eff\u7167 openai.OpenAI \/ anthropic.Anthropic \u7684"\u5382\u5546\u540d = \u5ba2\u6237\u7aef\u7c7b\u540d"\u60ef\u4f8b\u3002Nanobot.from_config() \u6697\u793a"\u5de5\u5382\u65b9\u6cd5\u6a21\u5f0f"，\u4fbf\u4e8e\u6d4b\u8bd5 mock\u3002<\/p>\n

\u51b3\u7b56 2 \u00b7 \u4e3a\u4ec0\u4e48 SDK \u66b4\u9732 sessions \/ memory \/ runtime \u5b50\u5ba2\u6237\u7aef？<\/h4>\n

nanobot \u7684\u4f1a\u8bdd \/ \u8bb0\u5fc6 \/ \u8fd0\u884c\u65f6\u662f\u72ec\u7acb\u5b50\u7cfb\u7edf，\u6bcf\u4e2a\u6709\u72ec\u7acb API（CRUD \/ \u8bfb\u53d6 \/ \u63a7\u5236）\u3002\u628a\u5b83\u4eec\u505a\u6210\u5b50\u5ba2\u6237\u7aef（SessionClient \/ MemoryClient \/ RuntimeClient）\u8ba9 bot.sessions.list() \u6bd4 bot.list_sessions() \u66f4\u6e05\u6670\u3002<\/p>\n

\u51b3\u7b56 3 \u00b7 \u4e3a\u4ec0\u4e48 OpenAI \u517c\u5bb9\u800c\u975e\u81ea\u521b\u534f\u8bae？<\/h4>\n

\u76f4\u63a5\u590d\u7528 OpenAI SDK \u751f\u6001\u2014\u2014\u4efb\u4f55\u8bed\u8a00\u3001\u4efb\u4f55\u5ba2\u6237\u7aef（LangChain \/ LlamaIndex \/ Cursor \/ Continue \/ \u81ea\u7814\u811a\u672c）\u96f6\u6210\u672c\u63a5\u5165\u3002<\/p>\n

\u51b3\u7b56 4 \u00b7 \u4e3a\u4ec0\u4e48 STREAM_EVENT_* \u7528\u5b57\u7b26\u4e32\u5e38\u91cf\u800c\u975e Enum？<\/h4>\n

\u524d\u7aef React \u7528\u5b57\u7b26\u4e32 event.type === "text_delta" \u5224\u65ad；\u540e\u7aef Python \u4e5f\u8981\u5e8f\u5217\u5316\u5230 JSON\u3002str \u5e38\u91cf\u6bd4 Enum \u517c\u5bb9\u6027\u66f4\u597d（\u65e0\u9700 value \u8bbf\u95ee）\u3002<\/p>\n

\u51b3\u7b56 5 \u00b7 \u4e3a\u4ec0\u4e48 SDK \u63d0\u4f9b RunStream（\u6d41）\u548c RunResult（\u975e\u6d41）\u4e24\u79cd\u8fd4\u56de？<\/h4>\n

\u975e\u6d41\u7b80\u5355（\u4e00\u6b21 await \u62ff\u7ed3\u679c）；\u6d41\u9002\u5408\u957f\u4efb\u52a1 + UI \u589e\u91cf\u6e32\u67d3 + \u5de5\u5177\u8c03\u7528\u53ef\u89c2\u6d4b\u3002\u4e24\u4e2a\u7c7b\u578b\u660e\u786e\u533a\u5206\u8ba9\u8c03\u7528\u65b9\u9009\u578b\u65e0\u6b67\u4e49\u3002<\/p>\n

7. \u6700\u4f73\u5b9e\u8df5（\u4e13\u680f\u6536\u5c3e）<\/h3>\n

\u5b9e\u8df5 1 \u00b7 \u811a\u672c\u8c03\u7528\u9996\u9009 SDK<\/h4>\n

import<\/span> asyncio
\nfrom<\/span> nanobot.<\/span>nanobot import<\/span> Nanobot<\/p>\n

async<\/span> def<\/span> main<\/span>(<\/span>)<\/span>:<\/span>
\n bot =<\/span> Nanobot.<\/span>from_config(<\/span>)<\/span>
\n result =<\/span> await<\/span> bot.<\/span>run(<\/span>"\u603b\u7ed3\u5f53\u524d\u76ee\u5f55\u7684 Python \u6587\u4ef6"<\/span>)<\/span>
\n print<\/span>(<\/span>result.<\/span>content)<\/span>
\n await<\/span> bot.<\/span>close(<\/span>)<\/span><\/p>\n

asyncio.<\/span>run(<\/span>main(<\/span>)<\/span>)<\/span><\/p>\n

\u5b9e\u8df5 2 \u00b7 \u591a\u5ba2\u6237\u7aef\u63a5\u5165\u7528 gateway<\/h4>\n

nanobot gateway # \u4e00\u6b21\u542f\u52a8，\u6240\u6709\u901a\u9053 + WebUI + API<\/span><\/p>\n

\u4e0d\u8981\u4e3a\u6bcf\u4e2a\u5ba2\u6237\u7aef\u8d77\u4e00\u4e2a nanobot \u8fdb\u7a0b\u2014\u2014\u6d6a\u8d39\u5185\u5b58 + session \u9694\u79bb\u3002<\/p>\n

\u5b9e\u8df5 3 \u00b7 \u81ea\u7814\u524d\u7aef\u7528 OpenAI \u517c\u5bb9 API<\/h4>\n

\u4efb\u4f55\u80fd\u8c03 https:\/\/api.openai.com\/v1\/chat\/completions \u7684\u5ba2\u6237\u7aef（\u524d\u7aef SDK \/ IDE \u63d2\u4ef6 \/ Slack bot）\u90fd\u80fd\u7528 http:\/\/your-nanobot:8765\/v1 \u66ff\u6362 endpoint，\u96f6\u4ee3\u7801\u6539\u52a8\u3002<\/p>\n

\u5b9e\u8df5 4 \u00b7 \u751f\u4ea7\u90e8\u7f72\u5173\u6ce8 3 \u4e2a\u6307\u6807<\/h4>\n\n\u6307\u6807\u76d1\u63a7\u4f4d\u7f6e<\/tr>\n\n\n\n\n
bus.outbound_size<\/td>\n\u9632\u6b62\u51fa\u7ad9\u5806\u79ef(\u89c1\u7b2c 04 \u7ae0 \u6d88\u606f\u603b\u7ebf)<\/td>\n<\/tr>\n
Session.file_size<\/td>\n\u9632\u6b62\u5355 session \u8fc7\u5927\u89e6\u53d1 AutoCompact \u6296\u52a8<\/td>\n<\/tr>\n
Provider 429 \u6bd4\u4f8b<\/td>\nFallbackProvider \u81ea\u52a8\u63a5\u7ba1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\u5b9e\u8df5 5 \u00b7 \u5347\u7ea7\u524d\u770b CHANGELOG + .agent\/<\/h4>\n

\u4ed3\u5e93\u6839\u6709：<\/p>\n

    \n
  • AGENTS.md \u2014\u2014 \u7ed9 AI Agent \u7684\u5f00\u53d1\u6307\u5357<\/li>\n
  • .agent\/design.md \u2014\u2014 \u67b6\u6784\u7ea6\u675f<\/li>\n
  • .agent\/security.md \u2014\u2014 \u5b89\u5168\u8fb9\u754c<\/li>\n
  • .agent\/gotchas.md \u2014\u2014 \u5e38\u89c1\u5751<\/li>\n<\/ul>\n

    \u5347\u7ea7\u524d\u901a\u8bfb\u8fd9 4 \u4e2a\u6587\u6863\u80fd\u907f\u5f00 90% \u7684\u517c\u5bb9\u6027\u95ee\u9898\u3002<\/p>\n

    8. \u5e38\u89c1\u95ee\u9898 \/ \u907f\u5751<\/h3>\n

    Q：SDK \u548c HTTP API \u540c\u65f6\u7528\u4f1a session \u51b2\u7a81\u5417？<\/h4>\n

    A：\u4f1a\u3002\u4e24\u8005\u5171\u4eab\u540c\u4e00\u4e2a ~\/.nanobot\/sessions\/<key>.jsonl\u3002\u5efa\u8bae：<\/p>\n

      \n
    • \u8c03\u8bd5\u65f6 SDK + HTTP \u4e8c\u9009\u4e00<\/li>\n
    • \u751f\u4ea7\u65f6\u7edf\u4e00\u8d70 gateway，\u591a\u5ba2\u6237\u7aef\u5171\u4eab\u540c\u4e00 loop<\/li>\n<\/ul>\n

      Q：\u600e\u4e48\u7981\u7528 HTTP API？<\/h4>\n

      A：\u5728 ~\/.nanobot\/config.json：<\/p>\n

      {<\/span> "api"<\/span>:<\/span> {<\/span> "enabled"<\/span>:<\/span> false<\/span> }<\/span> }<\/span><\/p>\n

      \u6216\u8005\u5e72\u8106\u7528 nanobot gateway（\u542b API）\u800c nanobot run（\u4ec5 CLI）\u3002<\/p>\n

      Q：\u6d41\u5f0f\u8c03\u7528\u4e2d\u9014\u65ad\u5f00\u4f1a\u600e\u6837？<\/h4>\n

      A:HTTP SSE \u9ed8\u8ba4 90 \u79d2\u7a7a\u95f2\u89c6\u4e3a\u65ad\u5f00(\u89c1\u7b2c 17 \u7ae0 LLMProvider \u62bd\u8c61)\u3002SDK \u7684 RunStream \u4f1a\u5728\u65ad\u5f00\u65f6\u629b asyncio.IncompleteReadError,\u7531\u8c03\u7528\u65b9\u51b3\u5b9a\u91cd\u8bd5\u6216\u56de\u9000\u5230\u975e\u6d41\u3002<\/p>\n

      9. \u5c0f\u7ed3<\/h3>\n
        \n
      • Nanobot \u95e8\u9762 = from_config() + sessions\/memory\/runtime \u5b50\u5ba2\u6237\u7aef + run() \u5165\u53e3<\/li>\n
      • SDK \u6d41\u5f0f\u4e8b\u4ef6 11 \u79cd\u7c7b\u578b，\u8986\u76d6 reasoning \/ \u5de5\u5177 \/ \u6587\u672c \/ \u56de\u5408\u8fb9\u754c<\/li>\n
      • HTTP API \u7aef\u70b9：\/v1\/models \/ \/v1\/chat\/completions \/ \/v1\/audio\/transcriptions \/ \/v1\/images\/generations<\/li>\n
      • \u6700\u4f73\u5b9e\u8df5：\u811a\u672c\u7528 SDK \/ \u591a\u5ba2\u6237\u7aef\u7528 gateway \/ \u81ea\u7814\u524d\u7aef\u7528 OpenAI \u517c\u5bb9<\/li>\n<\/ul>\n
        \n

        \u4e13\u680f\u6536\u5c3e<\/h3>\n

        \u81f3\u6b64 30 \u7ae0\u5168\u90e8\u5b8c\u6210\u3002\u56de\u987e\u5168\u4e13\u680f\u8986\u76d6\u7684 6 \u5927\u4e3b\u9898\u7fa4：<\/p>\n\n\u4e3b\u9898\u7fa4\u7ae0\u8282\u6838\u5fc3\u95ee\u9898<\/tr>\n\n\n\n\n\n\n\n
        \u67b6\u6784\u4e0e\u57fa\u7840\u8bbe\u65bd<\/td>\n01-09<\/td>\nnanobot \u7531\u4ec0\u4e48\u7ec4\u6210 \/ \u600e\u4e48\u8dd1 \/ \u6570\u636e\u600e\u4e48\u6d41<\/td>\n<\/tr>\n
        Agent \u6838\u5fc3<\/td>\n10-16<\/td>\nAgentLoop \/ Runner \/ Context \/ Session \/ Dream<\/td>\n<\/tr>\n
        LLM Provider \u9002\u914d<\/td>\n17-21<\/td>\n8 \u4e2a\u540e\u7aef\u600e\u4e48\u7edf\u4e00 \/ \u600e\u4e48\u63a5\u81ea\u5bb6\u6a21\u578b<\/td>\n<\/tr>\n
        \u804a\u5929\u901a\u9053<\/td>\n22-25<\/td>\n17 \u4e2a IM \u600e\u4e48\u96c6\u6210 \/ \u600e\u4e48\u81ea\u7814\u901a\u9053<\/td>\n<\/tr>\n
        Tool \u7cfb\u7edf<\/td>\n26-28<\/td>\n23 \u4e2a\u5de5\u5177\u600e\u4e48\u7ba1\u7406 \/ \u600e\u4e48\u53d1\u63d2\u4ef6<\/td>\n<\/tr>\n
        \u6269\u5c55\u4e0e\u8fd0\u7ef4<\/td>\n29-30<\/td>\n\u5b89\u5168 \/ SDK \/ API \/ \u90e8\u7f72<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

        \u4e0b\u4e00\u6b65\u5efa\u8bae：<\/p>\n

          \n
        • \u60f3\u770b\u4ee3\u7801 \u2192 \u8bfb nanobot\/agent\/loop.py \u4e3b\u4f53 + nanobot\/agent\/runner.py<\/li>\n
        • \u60f3\u8dd1\u8d77\u6765 \u2192 nanobot onboard + nanobot gateway + \u6253\u5f00 WebUI<\/li>\n
        • \u60f3\u63a5\u81ea\u5bb6 LLM \u2192 \u8bfb\u7b2c 19 \u7ae0 Provider \u5b9e\u73b0\u5bf9\u6bd4(\u4e3b\u9898\u7fa4"LLM Provider \u9002\u914d")<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

          \u672c\u7ae0\u662f\u4e13\u680f\u6536\u5c3e\u7bc7：\u89e3\u6790 nanobot\/nanobot.py \u7684 Nanobot \u95e8\u9762\u7c7b，\u4ee5\u53ca nanobot\/api\/server.py \u66b4\u9732\u7684 OpenAI \u517c\u5bb9 HTTP API\u3002\u8bfb\u5b8c\u672c\u7ae0\u4f60\u80fd\u7528\\”\u4efb\u610f\u80fd\u8c03 OpenAI SDK \u7684\u5ba2\u6237\u7aef\\”\u8c03\u7528\u4f60\u81ea\u5df1\u7684 nanobot \u5b9e\u4f8b\u3002 1. \u6574\u4f53\u5b9a\u4f4d：\u4e3a\u4ec0\u4e48\u9700\u8981 SDK OpenAI \u517c\u5bb9 API
          \n\u4e24\u79cd\u96c6\u6210\u573a\u666f：
          \n\u573a\u666f\u5165\u53e3\u7528\u9014Python \u96c6\u6210（\u5728\u811a\u672c \/<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[11833,7488],"topic":[],"class_list":["post-103994","post","type-post","status-publish","format-standard","hentry","category-server","tag-nanobot","tag-sdk"],"yoast_head":"\n\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wsisp.com\/helps\/103994.html\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"og:description\" content=\"\u672c\u7ae0\u662f\u4e13\u680f\u6536\u5c3e\u7bc7：\u89e3\u6790 nanobot\/nanobot.py \u7684 Nanobot \u95e8\u9762\u7c7b，\u4ee5\u53ca nanobot\/api\/server.py \u66b4\u9732\u7684 OpenAI \u517c\u5bb9 HTTP API\u3002\u8bfb\u5b8c\u672c\u7ae0\u4f60\u80fd\u7528"\u4efb\u610f\u80fd\u8c03 OpenAI SDK \u7684\u5ba2\u6237\u7aef"\u8c03\u7528\u4f60\u81ea\u5df1\u7684 nanobot \u5b9e\u4f8b\u3002 1. \u6574\u4f53\u5b9a\u4f4d：\u4e3a\u4ec0\u4e48\u9700\u8981 SDK OpenAI \u517c\u5bb9 API \u4e24\u79cd\u96c6\u6210\u573a\u666f： \u573a\u666f\u5165\u53e3\u7528\u9014Python \u96c6\u6210（\u5728\u811a\u672c \/\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wsisp.com\/helps\/103994.html\" \/>\n<meta property=\"og:site_name\" content=\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"article:published_time\" content=\"2026-09-11T08:25:02+00:00\" \/>\n<meta name=\"author\" content=\"admin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 \u5206\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/103994.html\",\"url\":\"https:\/\/www.wsisp.com\/helps\/103994.html\",\"name\":\"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"isPartOf\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\"},\"datePublished\":\"2026-09-11T08:25:02+00:00\",\"dateModified\":\"2026-09-11T08:25:02+00:00\",\"author\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/103994.html#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wsisp.com\/helps\/103994.html\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/103994.html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\/\/www.wsisp.com\/helps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\",\"url\":\"https:\/\/www.wsisp.com\/helps\/\",\"name\":\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"description\":\"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"contentUrl\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"caption\":\"admin\"},\"sameAs\":[\"http:\/\/wp.wsisp.com\"],\"url\":\"https:\/\/www.wsisp.com\/helps\/author\/admin\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wsisp.com\/helps\/103994.html","og_locale":"zh_CN","og_type":"article","og_title":"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","og_description":"\u672c\u7ae0\u662f\u4e13\u680f\u6536\u5c3e\u7bc7：\u89e3\u6790 nanobot\/nanobot.py \u7684 Nanobot \u95e8\u9762\u7c7b，\u4ee5\u53ca nanobot\/api\/server.py \u66b4\u9732\u7684 OpenAI \u517c\u5bb9 HTTP API\u3002\u8bfb\u5b8c\u672c\u7ae0\u4f60\u80fd\u7528\"\u4efb\u610f\u80fd\u8c03 OpenAI SDK \u7684\u5ba2\u6237\u7aef\"\u8c03\u7528\u4f60\u81ea\u5df1\u7684 nanobot \u5b9e\u4f8b\u3002 1. \u6574\u4f53\u5b9a\u4f4d：\u4e3a\u4ec0\u4e48\u9700\u8981 SDK OpenAI \u517c\u5bb9 API \u4e24\u79cd\u96c6\u6210\u573a\u666f： \u573a\u666f\u5165\u53e3\u7528\u9014Python \u96c6\u6210（\u5728\u811a\u672c \/","og_url":"https:\/\/www.wsisp.com\/helps\/103994.html","og_site_name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","article_published_time":"2026-09-11T08:25:02+00:00","author":"admin","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"admin","\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4":"5 \u5206"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wsisp.com\/helps\/103994.html","url":"https:\/\/www.wsisp.com\/helps\/103994.html","name":"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","isPartOf":{"@id":"https:\/\/www.wsisp.com\/helps\/#website"},"datePublished":"2026-09-11T08:25:02+00:00","dateModified":"2026-09-11T08:25:02+00:00","author":{"@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41"},"breadcrumb":{"@id":"https:\/\/www.wsisp.com\/helps\/103994.html#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wsisp.com\/helps\/103994.html"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wsisp.com\/helps\/103994.html#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/www.wsisp.com\/helps"},{"@type":"ListItem","position":2,"name":"\u7b2c 30 \u7ae0\u300aPython SDK + OpenAI \u517c\u5bb9 API + \u6700\u4f73\u5b9e\u8df5\u300b\u00b7 nanobot SDK + OpenAI \u517c\u5bb9 API \u6e90\u7801\u89e3\u6790\uff1aNanobot \u95e8\u9762 + \/v1\/chat\/co"}]},{"@type":"WebSite","@id":"https:\/\/www.wsisp.com\/helps\/#website","url":"https:\/\/www.wsisp.com\/helps\/","name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","description":"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"zh-Hans"},{"@type":"Person","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41","name":"admin","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/","url":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","contentUrl":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","caption":"admin"},"sameAs":["http:\/\/wp.wsisp.com"],"url":"https:\/\/www.wsisp.com\/helps\/author\/admin"}]}},"_links":{"self":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/103994","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/comments?post=103994"}],"version-history":[{"count":0,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/103994\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/media?parent=103994"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/categories?post=103994"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/tags?post=103994"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/topic?post=103994"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}