้กน็ฎๅฃฐๆ
ๆฌ้กน็ฎไธบไธชไบบๅผๆบ๏ผไพ่ช็ฑๅญฆไน ไบคๆต๏ผ้ตๅพช MIT ๅผๆบๅ่ฎฎ๏ผๅฏ่ช็ฑๅๅใ
ๅ้กน็ฎๅ็งฐใไบๆขใไธๅ ถไปไผไธ้กน็ฎ้ๅ๏ผไธบ้ฟๅ ๆททๆท๏ผ็ฐๆดๅไธบใNanZiใใ
ใNanZiใๆฅ่ชๆไธ็ดไฝฟ็จ็็ฝๅ๏ผๅๅญ๏ผ๏ผๅใๅญๅญไธๅฆใไนๆ๏ผๅฏๆ AI ๆ็ปญๅญฆไน ไธ่ฟๅใ
NanZi ยท ๆบ่ฝไฝๅนณๅฐ (NanZi AI Agent Platform)
็ฎไฝไธญๆ | English
ไผไธ็บง AI ๆบ่ฝไฝ็ผๆไธๆง่กๅนณๅฐ
Connect Data. Orchestrate Intelligence.
๐ ๅฎๆ่ฟ่ฝฝ๏ผNanZi ๅผๆบๆบ่ฝไฝๅนณๅฐๅฎๆ่ฟ่ฝฝ๏ผๆถๆ ยท ๅฎ่ฃ ยท ๆบ่ฝไฝ้ ็ฝฎ ยท ChatBI ยท ๅทฅๅ ท็ฎฑ ยท MCP๏ผ
> โ ็้พ่งฃ็ญ๏ผ็้พ่งฃ็ญไธๅธธ่ง้ฎ้ขๆๅ (FAQ)
> ๐ ๅจ็บฟไฝ้ช๏ผๆซ็ ่ฟ็พค่ทๅๅ ่ดนไฝ้ช่ดฆๅทไธไฝ้ชๅฐๅ๏ผ่งไธๆนใ่็ณปไธไบคๆตใ
NanZi ๆบ่ฝไฝๅนณๅฐ ๆฏไธไธบไผไธ็บงๅคๆๅบๆฏๆ้ ็ AI ๆบ่ฝไธญๆขใ
ๅนณๅฐๆ ธๅฟ่็ฆไบไปฅไธ่ฝๅ็ฉ้ต๏ผ
- ๐ฌ ๆทฑๅบฆไบคไบๅผๅฏน่ฏ (Dialogue & Co-Agent)๏ผๆ้ๆตๅผๅๅบ๏ผๆฏๆ ๆบ่ฝๅงๆดพ๏ผ้ป่ฎค่ฟๅ
ฅ Main๏ผ ไธ ไธๅฎถๆจกๅผ / @ๆๅ็ด้ใๅคไธๅฎถๅๅใๅ
็ฝฎ ๅทฅๅ
ท้ขๆฃ ไฟๅๆจกๅไธปๅจ่ฐ็จๅทฅๅ
ท๏ผๆฏๆ
ask_user_questionๆบ่ฝๆ้ฎๅก๏ผๅ้/ๅค้/่พๅ ฅ๏ผใTodo ไปปๅกๆธ ๅ ๅๆญฅๆง่กไธๅธธ้ฉป่ท่ธช๏ผไธปๅฉๆๆฏๆ Skill ่ชๅจๆซๆ ไธๆ้ๆ่ตทๆขๅคใ - ๐ก๏ธ ๅค็ญ็ฅๅฎๅ จๆฒ็ฎฑไธ้็ฆปๆง่ก (Multi-Policy Sandbox)๏ผๅ็ๆฏๆ Local๏ผๆฌๆบ่ฟ็จ๏ผใDocker๏ผ็งๆๅฎนๅจ้็ฆป๏ผใK8s๏ผKubernetes ๅ็ Pod ๆฒ็ฎฑ๏ผไบๅ็ๅ Docker Socket ๅฎๅ จๆจ่๏ผใE2B๏ผไบ็ซฏๅฎๅ จๆฒ็ฎฑ๏ผใSSH๏ผ่ฟ็ซฏๅฎๅ จ้้๏ผไบๅคงๆง่ก็ญ็ฅ๏ผDocker ไธ K8s ๆจกๅผๆฏๆ็จๆทๅทฅไฝๅบๅ่ทฏๅพ/subPath ๆ่ฝฝ๏ผๆฏๆๅจไปฃ็ ็ปๅธไธญ็ดๆฅๆๅผ้ข่งๅนถไฟๅญๅ็ฉ็ๆไปถ๏ผๆฏๆ้ๅ้ขๆๅปบใ็ฉบ้ฒ 30 ๅ้่ชๅจๅๆถ๏ผIdle Reaper๏ผใไผ้ ๅๆบๆธ ็ๅ่พๅ ฅๆกๆตฎๆ ้ขๆฟไธ้ฎๆขๆตไธ็ง็บง่ฟ่กๆถ้ฟ็ๆงใ
- ๐ ๆไน ๅๆต่งๅจไผ่ฏไธๅฎๆถๆฅ็ฎก้ขๆฟ (Persistent Browser & Live Takeover)๏ผๆๅก็ซฏๆไน ๅๆต่งๅจไผ่ฏไธๅ จๅฅ่ชๅจๅๅทฅๅ ท๏ผ็ฝ้กต่ฎฟ้ฎใ็นๅปใ่พๅ ฅใๆไบบๆปๅ่ฝจ่ฟนๆๆฝใๆ้ฎใๆปๅจใๆชๅพไธๅคๆ ็ญพ๏ผ๏ผๅ็ซฏๅณไพงๆไพๅฎๆถ Web ไบคไบ้ขๆฟ๏ผๆฏๆๅฟซ็ งไธฒๆตๆธฒๆไธๆ ็ผไบบๆบๅๅไบคไบๆฅ็ฎกใ
- ๐ ๅ็ไผไธ็บง ChatBI ไธ่ชๆๅๆ (ChatBI & Self-Healing)๏ผๆฐๆฎๆบไธๅ
ๆฐๆฎ็ฎก็ใๅ
ๆฐๆฎไธ่ดๆงๅทกๆฃไธ Schema ๆผ็งปๆฒป็ใๆกไพ้ Few-ShotใSQL ่ชๆไธ sql_plan ็ปๆๅ่ฎกๅ๏ผๆ็ๆฐๆฎ้จๆท๏ผ
/dataset_portal๏ผไธชๆงๅๅฏผ่ช๏ผๆฏๆ็ด่ฟ็ฉ็ SQL ไธ้ป้ๆฅ่กจๆๅญ่ฎข้ ใ - ๐ง ้ฟๆ่ฎฐๅฟไธ่ทจไผ่ฏๅ้กพ (Memory & LTM)๏ผLTM ๅๅฅฝๆณจๅ
ฅ + ๅ
็ฝฎ
memory_searchๆ้ๆฃ็ดขไผ่ฏ/ๆฏๆฅๆ่ฆ๏ผ่ฎฐๅฟ็ฎก็ไธญๅฟๆไพๅ้ๆฃ็ดข่ฟ็ปดไธๆฐๆฎๆฒป็๏ผๅ จ้พ่ทฏ Redis ไผ่ฏ่ฎฐๅฟไธๅ็ผฉๆฅๅฟ TTL ๅ จ้ขๅ็บงไธบ 30 ๅคฉใ - ๐ ไธไธๆๅ้กนๆ่งฃ่งๆตไธๆบขๅบๆบ่ฝๅ็ผฉ (Context Observability & Compaction)๏ผ็ฒพๅๅฎๆถๆ่งฃ System PromptใTools SchemaใMemory/History ไธ Current Turn ๅๅคง้กน Token ๅ ๆฏ๏ผๆฏๆ่ชๅจๆฐดไฝ็บฟๅ่ญฆไธไธค้ถๆฎต็ปๆๅๅ็ผฉ๏ผ
_structured_tool_block็ฒพๅๆ็ผใไฟ็ๅคๆจกๆ้ไปถๆ ่ฎฐ๏ผใ - ๐งฉ ไปฃ็ ็ปๅธไธๅทฅไฝๅบๆง่ก (Code Canvas & Workspace)๏ผๆฏๆ Python / Shell ไปฃ็ ็ๆตๅผ่ฟ่กใๅๆญขใ่พๅบๅไผ ไธ็งๆๅทฅไฝๅบๆไปถ้ข่ง๏ผๆฏๆ
publish_generated_fileๆบ่ฝๅทฅไปถๅๅธไธๆๆๆ็ฎก็ใ - ๐ ๅฏ่งๅ็ฅ่ฏๅบ็ฎก็ไธญๅฟ (RAG & Knowledge Hub)๏ผ้็ปๆๅๆๆกฃๆ ๅฝข็ฎก็ใๅฌๅๆต่ฏใ่ฏญไนๅๅนถ๏ผKnowledge ๆง่กๅจๅจ ReAct ๅ่ชๅจๆฃ็ดขๅนถๆณจๅ ฅๅผ็จใ
- ๐ ๅๅไผไธ็บง MCP ็ๆ (Platform & Client MCP)๏ผๅบ็ซ่ฐ็จๅค้จ MCP ๅทฅๅ ทๆถ่ชๅจ้ไผ ็จๆท่บซไปฝไธไธๆไฟ้ๅค็งๆทไธๆ้้็ฆป๏ผๅๆถๅ็ๅฏนๅคๆไพ NanZi Platform MCP ๆๅก๏ผOAuth2 ้ดๆไธๆๅกๅฐ๏ผ๏ผๆฏๆ CursorใClaude Desktop ็ญๅค้จๅฎขๆท็ซฏๅ ๆน้ ่ฐ็จ NanZi ๆบ่ฝไฝใไผ่ฏไธๅ ๆฐๆฎใ
- ๐ ็ตๆดป็ๅตๅ ฅๅผ (Embed) ้ๆ๏ผ้่ฟๅตๅ ฅๅผ Chat SDK ๅฟซ้้ๆ่ณไผไธไธๅก็ณป็ป๏ผๅฏนๆฅ็ฐๆ้ดๆไฝ็ณป๏ผๅฎ็ฐ็งๆท้็ฆปใRBAC ๆ้ไธๆฐดๅฐๅฎๅ จๅ่งใ
- โฐ ่ชๅจๅไปปๅกไธญๅฟไธๅค้้ๆจ้ (Task Scheduler & Notifications)๏ผAPScheduler + Redis ๆง่กๆ้๏ผๆฏๆ้่ฟ็ฏๅขๅ้ๆๅฎๅฏไธ่ฐๅบฆ่็น๏ผๆจกๆๆบ่ฝไฝ่บซไปฝ่ชไธปๆง่กๅจๆ๏ผCron๏ผใๅฎๆถไธ้ด้ไปปๅก๏ผๆฏๆ ๅค้้ๆบ่ฝ่งฆ่พพ๏ผไผไธๅพฎไฟกใ้้ใ้ฃไนฆใ้ฎไปถใ่ชๅฎไน Webhook ๅ็ซๅ ไฟก้็ฅไธญๅฟ๏ผ๏ผๅ ็ฝฎ่ชๅจๅฅ็ฆปๆ่่ฟ็จ๏ผ็บฏๅไธๅกๆ่ฆๆจ้๏ผใ่ถ ้ฟๆชๆญไฟๆคไธ้ป้ๆฅ่กจๅผๅธธ้ๅผๅ่ญฆใ
- ๐ ๏ธ ๅ จ้พ่ทฏ Debug ไธ Trace๏ผๅณ็ญ้พใๅทฅๅ ท่ฐ็จใSQL ่ฎกๅๅก็ๅฏ่งๅ๏ผ็ปๆๅๆฅๆฐ็ปๆ CSV/Excel ๅฏผๅบใ
- โ๏ธ ๆ ๅๅ API ๅผๆพ๏ผๆ ๅๅ V1 API ๆฅๅฃ๏ผๆฏๆๅค้จ็ณป็ป้่ฟ API ็ดๆฅ่ฐ็จๆบ่ฝไฝ็ผๆไธๆง่ก่ฝๅใ
- ๐ฏ ๆ็คบ่ฏๅทฅๅ (Prompt Factory)๏ผ็ณป็ปๆ็คบ่ฏ็ๆฌ็ฎก็ไธ่็จฟ๏ผ
architech/prompts/๏ผ๏ผ็ไบง่กไธบๅฏๆงๅฏๅฎก่ฎกใ
๐๏ธ ็ณป็ปๆถๆ (Architecture)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ NanZi ๆบ่ฝไฝๅนณๅฐ โ
โโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โ โ
[ ๅตๅ
ฅๅผ่ๅคฉ SDK ] [ ็ฎก็ๆงๅถๅๅฐ ]
(Embed Chat SDK) (Admin Console)
โ โ
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
โ SSE/HTTP
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆ ธๅฟ็ฝๅ
ณ (Portal Gateway) โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โ โ ็ปไธ้ดๆ โ โ Main ๅงๆดพ โ โ ไปปๅก่ฐๅบฆ โ โ ๅฎก่ฎกๅๆบฏ โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โ โ (็ถๆไธ้ๅ)
โ โโโโโโโผโโโโโโ
โ โ Redis โ
โ โโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆบ่ฝไฝไธๅฎถ้็พค (Expert Pool) โ
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ ChatBI ไธๅฎถ โ โ RAG ็ฅ่ฏไธๅฎถ โ โ ๆไปถๅฉๆโ โ
โ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโฌโโโโโโ โ
โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโ
โ (ReAct ๅพช็ฏ) โ (ๆ็ฎก่ทฏ็ฑ) โ (ๅทฅๅ
ท้พ่ฐ็จ)
โโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโ
โ ๆบ่ฝไฝ่ฟ่กๅผๆ (Execution Engines) โ
โ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
โ โ AgentScope ReAct โ โ RAGFlow Agentโ โ OpenClaw๐ฆ โ โ
โ โ (Loop & ่ชๆSQL) โ โ (ๆ็ฎกๆบ่ฝไฝ) โ โ (AUTHไธไธๆ) โ โ
โ โโโโโโโโโโฌโโโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโ โ
โโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโ
โ โ โ
โโโโโโโโโโโโโผโโโโโโโโ โโโโโโโโโโโผโโโโโโ โโโโโโโโโโโผโโโโโโโโโ
โ ไผไธๅคๆบๆฐๆฎไป/DB โ โ RAGFlow ็ฅ่ฏๅบ โ โ MCP Server โ
โ (Oracle/CK/MySQL) โ โ (้็ปๆๅๆฐๆฎ) โ โ (ๅค้จ็ณป็ป/API) โ
โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ๐ผ๏ธ ็้ข้ข่ง (Interface Snapshots)
| ๐ ไปช่กจ็ๆฆ่ง (Overview Dashboard) | ๐ฌ ๆบ่ฝๅฉๆๅฏน่ฏ (AI Chat) | | :-----------------------------------------------: | :------------------------------------------------: | | !ไปช่กจ็ๆฆ่ง | !ๆบ่ฝๅฉๆ | | ๐ง ้ฟๆ่ฎฐๅฟไธๆ ๆๅๅฟ (Memory & LTM) | ๐ ่ฎฐๅฟ็ฎก็ๆงๅถๅฐ (Memory Manage) | | !่ฎฐๅฟไธๅๅฅฝ | !่ฎฐๅฟ็ฎก็ๆงๅถๅฐ | | ๐ ๏ธ ๅณ็ญ้พ่ทฏ่ฐ่ฏ (Trace Timeline) | ๐ ็ฅ่ฏๅบๅทฅไฝๅฐ (Knowledge Hub) | | !่ฐ่ฏ้พ่ทฏ | !็ฅ่ฏๅบ | | ๐ค ๆบ่ฝไฝ็ผๆ (Agent Studio) | ๐ ๆ็คบ่ฏๆธธไนๅบ (Prompt Playground) | | !ๆบ่ฝไฝ | !ๆ็คบ่ฏ | | ๐ ็ด่ฟ็ฉ็ๆฐๆฎๆบ (Data Sources) | ๐ ๅ ๆฐๆฎๆบ่ฝๆๅปบ (Metadata) | | !ๆฐๆฎๆบ | !ๅ ๆฐๆฎ | | โก ๆบ่ฝไฝๅจๆๆ่ฝ (Agent Skills) | โ๏ธ ็ณป็ป็ฎก็่ฎพ็ฝฎ (System Settings) | | !ๆ่ฝ | !็ณป็ป้ ็ฝฎ |
๐ ๆ ธๅฟ่ฝๅ (Core Capabilities)
1. ๐ง ๅคๅผๆไธๆททๅ็ผๆ (Multi-Engine & Hybrid Orchestration)
- ๆบ่ฝๅงๆดพ๏ผๆชๆๅฎๆบ่ฝไฝๆถ็ดๆฅ่ฟๅ
ฅ
Main๏ผ็ฑ Main ๆ นๆฎไปปๅกๅคๆญ็ดๆฅๅ็ญ๏ผๆ้่ฟsub_agent_call/sub_agent_batch_callๆ้ๅงๆดพๅทฒๆๆไธๅฎถ๏ผไธๅๅขๅ ๅคๅฑ่ฏญไน่ทฏ็ฑ LLMใ - ไธๅฎถ็ด้๏ผEmbed ไธๅฎถๆจกๅผใ
agent_idๆ@ๆๅไฟๆ็ด่พพๆๅฎๆบ่ฝไฝ๏ผๆๅฎไธๅฎถๅไปๅฏ็ฑ่ฏฅไธๅฎถ็ปง็ปญๅงๆดพๅ ถไปๅญไปฃ็ใ - AgentScope ReAct๏ผAssistant / ChatBI / Knowledge ๅบไบ AgentScope Agent + Toolkit๏ผ้ญ็ฏ่ฐๅบฆๆฌๅฐๅทฅๅ ท๏ผๆฏๆๆ้ๆ่ตทไธๆขๅคใ
- ไธปๅฉๆๅขๅผบ๏ผๅทฅๅ ท้ขๆฃ๏ผๆ็ปๅฎๅทฅๅ ท็ธๅ ณๅบฆไฟๅ่ฐ็จ๏ผใSkill ่ชๅจๆซๆใๅไธๅกๆฐๆฎๅนป่ง Guard๏ผๅฏไธ้ฎๅๆข ChatBI๏ผใ
- ๆ่ๆจกๅๅ
ผๅฎนๅฑ๏ผๆฏๆ DeepSeek-R1ใKimi ็ญๆ่ๆจกๅๅฑๅผไธ 6 ็บง
reasoning_effort่ฐไผ๏ผ่ชๅจๆ่ฝฝtool_choice_for_model็กฎไฟๅทฅๅ ท็จณๅฎ่งฆๅใ - RAGFlow ๆ็ฎก Agent๏ผๅฏนๆฅ RAGFlow ๅจ็บฟๆ็ฎกๆบ่ฝไฝ๏ผๅค็จๅ ถๆฃ็ดขไธๆตๅผๅฏน่ฏ่ฝๅใ
- OpenClaw๐ฆ ๅฎๅ
จ็ฝๅ
ณ๏ผ้่ฟ
AUTH_CONTEXT้ไผ ็จๆท่บซไปฝใ้ข้ๅๅฏ่ฎฟ้ฎๆฐๆฎ้๏ผไฟ้็งๆท้็ฆปใ
2. ๐ก๏ธ ๅค็ญ็ฅๅฎๅ จๆฒ็ฎฑไธ้็ฆปๆง่ก (Multi-Policy Sandbox & Isolation)
- ไบๅคงๆฒ็ฎฑ็ญ็ฅ๏ผๅ็ๆฏๆ
Local๏ผๆฌๆบๅฎๅ จ้็ฆป๏ผใDocker๏ผ็งๆๅฎนๅจ้็ฆป๏ผใK8s๏ผKubernetes ๅ็ Pod ๆฒ็ฎฑ้็ฆป๏ผใE2B๏ผไบ็ซฏๅฎๅ จๆฒ็ฎฑ๏ผใSSH๏ผ่ฟ็จๆๅกๅจๅฎๅ จ้้๏ผใ - SSH ่ฟ็จๆฒ็ฎฑๅๆๆกไปถ๏ผ
ssh็ญ็ฅ็ฑๅนณๅฐไธปๆบ่ช่บซ็sshCLI ่ฟๆฅ่ฟ็ซฏไธปๆบ๏ผๅนณๅฐไธปๆบ๏ผๆๅนณๅฐๅฎนๅจ๏ผ้ๅ ทๅคopenssh-client๏ผๅฏ็ ่ฎค่ฏ้ขๅค้่ฆsshpass๏ผ็ง้ฅ่ฎค่ฏๆ ้๏ผ๏ผไธๅ ๅบๅฎๅฏ็จStrictHostKeyChecking=yes๏ผ่ฟ็ซฏไธปๆบๅฏ้ฅๅฟ ้กป้ขๅ ๅฝๅ ฅknown_hostsใๅฎๆดไพ่ตๆธ ๅไธๆฅ้ๅฏน็ ง่ง FAQ 7.3.7 SSH ๆฒ็ฎฑ่ฟ่กๅๆๆกไปถไธ่ฟๆฅๆๆฅใ - ไบๅ็ K8s Pod ๆฒ็ฎฑ๏ผKubernetes ้็พค็ไบง้จ็ฝฒๅ
ๆ่ฝฝๅฎฟไธปๆบ Docker Socket๏ผ
/var/run/docker.sock๏ผ๏ผ้่ฟ K8s API ๅจๆๆ่ตท้็ฆป Pod๏ผๅๅฉๅนณๅฐ PVC ็subPathๆ่ฝฝ็จๆทๅทฅไฝๅบ๏ผไฟ้้่/ๆฟไผ็บงๅฎๅ จๅ่งใ - ๅทฅไฝๅบ็ฉ็ๅๅพ / subPath ๆ่ฝฝ๏ผ็จๆทๅทฅไฝๅบ็ดๆฅๆ่ฝฝ่ฟๅฎนๅจ/Pod๏ผ่ชๅจๅฐ้ป่พๅทฅไฝๅบ่ทฏๅพ่ฝฌไนๆ ๅฐ่ณๅฎฟไธปๆบ/PVC ็ฉ็ๆไปถ๏ผๆฏๆๅณไพงไปฃ็ ็ปๅธ็ดๆฅๆๅผใ้ข่งๅนถไฟๅญๅ็ฉ็็ฃ็ใ
- ๆฒ็ฎฑ็ๅฝๅจๆ่ชๅจๅ๏ผๆฏๆๅๅฐ 30 ๅ้็ฉบ้ฒ่ชๅจ้ๆฏ๏ผIdle Reaper๏ผใๆๅก้ๅฏไผ้ ๅๆบๆธ ็๏ผๅฎๅถ็ๅฝๅจๆ้้ ๅจไฟๆคๅ ฑไบซๅญๅจ็ปไธ่ฏฏๅ ใ
- ่พๅ ฅๆกๆตฎๆ ๆงๅถๅฐ๏ผๅณไธ่งไธไธๆๆตฎๆ ๆ ็ผ่ๅๆฒ็ฎฑ็ถๆ๏ผ๐ขๅทฒ่ฟ่ก/๐กๅฏๅจไธญ/๐ดๅคฑ่ดฅ/โชๆชๅฏๅจ๏ผใๅฝๅๅ้ ๅฎนๅจ/Pod IDใๅฎๆถ็ง็บง่ฟ่กๆถ้ฟไปฅๅๆๅจๅฏๅจ/้ๅฏ/ๅๆญขๆงๅถใ
3. ๐ ๆๅก็ซฏๆไน ๅๆต่งๅจไผ่ฏไธๅฎๆถๆฅ็ฎก (Persistent Browser & Live Takeover)
- ๅฎๆด่ชๅจๅๅฅไปถ๏ผๆฏๆๆๅผ็ฝ้กตใๅ ็ด ็นๅปใ่กจๅ่พๅ ฅใๆไบบ่ฝจ่ฟนๆปๅๆๆฝใๆบ่ฝ็ญๅพ ใๆ้ฎใๅ จ้กตๆปๅจใๆไปถไธไผ ใๆชๅพไธๅคๆ ็ญพ้กต็ฎก็ใ
- ๅณไพง Web ไบคไบ้ขๆฟ๏ผๅ็ซฏๆฏๆๆไน ๅๆต่งๅจ้ขๆฟ๏ผๅฟซ็ งไธฒๆตๅฎๆถๅ็ฐ๏ผๆฏๆ็จๆท้ๆถ็นๅปๆฅ็ฎกไบบๅทฅ่พๅ ฅๆ้ช่ฏ็ ไบคไบ๏ผไบบๆบๅๅ้ญ็ฏใ
4. ๐ ไธไธๆๆบ่ฝ้ข็ฎไธๆบขๅบๅ็ผฉ (Context Management & Observability)
- ๅ็ปดๅ้กนๆ่งฃไธๅฏ่งๅ๏ผ็ฒพ็กฎไผฐ็ฎๅนถๅ็ฐ System PromptใTools SchemaใMemory/History ไธ Current Turn ็ Token ๅ ๆฏๆกๅฝขๅพใ
- ๆบ่ฝๆบขๅบๅ็ผฉ๏ผ่งฆๅ็ฉ็็ชๅฃ้ๅผๆถ่ชๅจ่งฆๅไธค้ถๆฎต็ปๆๅๅ็ผฉ๏ผๆ็ผๅทฅๅ
ท่ฐ็จไบง็ฉ๏ผ
_structured_tool_block๏ผๅนถไฟ็้่ฆๅคๆจกๆๅพ็ๆ ่ฏใ - 30 ๅคฉ้ฟๆ่ฎฐๅฟ็ผๅญ๏ผๅ จ้พ่ทฏ Redis ่ฎฐๅฟไผ่ฏใๅ็ผฉๆฅๅฟไธ็ๆๅทฅไปถไธ่ฝฝ้พๆฅๅ จ้ขๅ็บงไธบ 30 ๅคฉ้ฟๆไฟๅญใ
5. ๐ ๆบ่ฝๆฐไปๅๆ (ChatBI & Self-Healing)
- Text-to-SQL ้ญ็ฏ๏ผๅ ๆฐๆฎๆณจๅ ฅ + Schema ้จ็ฆ + ๅคๅฑ SQL ๆคๆ ๏ผ่ช็ถ่ฏญ่จ็ดๆฅไธๅกๅบใ
- ๆ็ๆฐๆฎ้จๆท๏ผ็ณป็ปๆไปค
/dataset_portal๏ผๅ ผๅฎนๆง/dataset_menu๏ผ๏ผๆๆ้็ๆๆฐๆฎ้ๅฏผ่ชไธ quick ่ฟฝ้ฎใ - ๆกไพ้ไธ Few-Shot๏ผ็ป้ชๅบๅฎกๆ ธๅ ฅๅบ๏ผ็ธไผผๆกไพๅจๆๆณจๅ ฅๆ็คบ่ฏๅคด้จๆๅไธๆ SQL ๅ็กฎ็๏ผๆกไพๅ้ๅๆญฅ็ฎๆ ๆๆฃ็ดขๆจกๅผ่ชๅจๅบๅ๏ผRAGFlow ๆจกๅผๅๆญฅ RAGFlow+ๆฌๅฐ Redis๏ผๆฌๅฐๆจกๅผไป ๅๆญฅๆฌๅฐ Redis ๅ้๏ผใ
- ่ชๆไธ่ฎกๅๆจๆผ๏ผSQL ๆฅ้่ชๅจไฟฎๅค่ฝฎๆฌก๏ผๅฏ้
enable_sql_plan่ฆๆฑ้ซ้ฃ้ฉๆฅ่ฏขๅ ่พๅบ็ปๆๅ - ่ฟ็ปญๅๆๅทฅไฝๆต๏ผ้ๆฅๆฐ่ฏทๆฑๅฏๆฌๅฐๅ็ญๆๆ ๆๅงๆดพ๏ผ็ปๆๆ ๆฏๆๅผ็จใๆกไปถ็ปงๆฟไธ้ปใๆททๅไปปๅกไธฒ่กๆง่ก๏ผๅนถๅบๅ็ปๆๅๆใๅ็ฐใๅจไฝๅๆฐๆฅๆฐใ
- ๅ ๆฐๆฎไธๅกๅฏผ่ช๏ผๅญๆฎตไธๅฃๅพๅ็ญๅบไบๆๆ Schema ็ๆๆๆ ใ็ปดๅบฆๅๅฏๆง่ก้ฎ้ข๏ผๆพๆธ ๅ้ไธไฝฟ็จๆจกๅ่้ ๅญๆฎตใ
- ๅๆไบคไป้ญ็ฏ๏ผๆฅ่ฏข็ปๆๅฏไธ้ฎ็ๆ่ฏๆฎๅ Markdown/Word ไธๅก็ฎๆฅ๏ผๆ่ฝฌไธบ้ป้ๆฅ่กจ่ฎข้ ๏ผ้ ็ฝฎ้ๅผใๅๅ็ใ่ฟ็ปญๅฝไธญๅๆ ๆฐๆฎๅ่ญฆใ
- ๆฐๆฎๆบ็ฎก็๏ผๅฏ่งๅ็ฎก็ Oracle / ClickHouse / MySQL ็ญ่ฟๆฅ๏ผๆฏๆ DDL ๆๅไธ่ฟๆฅๅซๅๅฏไธๆ ก้ช๏ผๆฏๆ้ป้ๆฅ่กจๆๅญไธ็ด่ฟ็ฉ็ SQL ๆง่กใ
- ๅ ๆฐๆฎๅทกๆฃไธ Schema ๆผ็งปๆฒป็๏ผ็ด่ฟ็ฉ็ๆฐไปๅฎๆไฝๆฃ๏ผ้ถ Token ๆถ่๏ผไธ่ฟ่กๆถๆฅ้่ชๅจๅๅบ๏ผ็ฒพๅ่ฏๅซ่กจ/ๅญๆฎต็ผบๅคฑไธ็ฑปๅไธๅน้ ๏ผๆฏๆไธ้ฎไบบๆบๅๅๆ กๅใๅๆดๆฅๅฟ Diff ๅฎก่ฎกไธๅค้้ๅ่ญฆๆจ้ใ
6. ๐ ๅๅๅผๆพๆไปถ็ๆ (MCP Integration)
- ๅบ็ซ่ฟๆฅไธ็จๆทไธไธๆ้ไผ ๏ผๆบ่ฝไฝ่ฐ็จๅค้จ MCP ๅทฅๅ ทๆถ๏ผๅจๅ่ฎฎๅฑ่ชๅจ้ไผ ๅฝๅ็ปๅฝ็จๆท่บซไปฝไธไธๆ๏ผ็จๆทใ่ง่ฒใ็งๆทไธๆฐๆฎ่ๅด๏ผ๏ผ็กฎไฟไธๆธธๅค้จ็ณป็ปๅฎๆฝ็ฒพๅ็ๅค็งๆท้็ฆปไธๆไฝๅฎก่ฎกใ
- NanZi Platform MCP ๅฏนๅคๆๅก๏ผๅนณๅฐๅ็ไฝไธบ MCP ่ตๆบๆๅก็ซฏ๏ผๆฏๆๆ ๅ OAuth2 ้ดๆไธใMCP ๆๅกๅฐใ็ฎก็๏ผไฝฟ CursorใClaude Desktop ็ญๅค้จๅฎขๆท็ซฏๅฏ็ดๆฅๆฃ็ดขไธ่ฐ็จ NanZi ็บณ็ฎก็ๆบ่ฝไฝใไผ่ฏไธๆฐไปๅ ๆฐๆฎใ
- ๆ ้็ๆ่ฟๆฅ๏ผๆ ้ไฟฎๆนๅนณๅฐๆ ธๅฟไปฃ็ ๏ผๅณๅฏๅๅๅฏนๆฅ็ไบงๅ็ณป็ปไธๅค Agent ๅไฝ็ๆใ
7. ๐ ๆทฑๅบฆ็ฅ่ฏๅขๅผบไธ้ๆ (RAG & Knowledge Hub)
- ไธ็ซๅผ็ฅ่ฏๅบ็ฎก็๏ผๆ ๅฝขๆๆกฃ็ฎก็ใๅ็้ข่งใๅฌๅๆต่ฏใ่ฏญไนๅๅนถไธ็ๅฝๅจๆๅฎก่ฎกใ
- Knowledge ๆง่กๅจ๏ผๅฏน่ฏไธญ่ชๅจ
search_knowledge_base้ขๆฃ็ดข๏ผReAct ้ถๆฎตๆณจๅ ฅๅผ็จๅก็๏ผ็ฉบๅฌๅ/ๆ ๅผ็จๅ็ญๅฏๆฆๆชใ - RAGFlow ๆ็ฎก่ทฏๅพ๏ผไบฆๅฏไธ้ฎๅฏนๆฅ RAGFlow ๆ็ฎก็ฅ่ฏๆบ่ฝไฝ๏ผๅค็จๅค้จๆฃ็ดขไธๆตๅผๅบๅบงใ
8. ๐ ๏ธ ไผไธ็บง้ ๅฅไธๅฎๅ จๅฎก่ฎก (Enterprise Toolkit & RBAC)
- ่ชๅจๅไปปๅกไธญๅฟไธๅค้้ๆจ้๏ผAPScheduler + Redis ๆง่กๆ้๏ผๆฏๆ้่ฟ็ฏๅขๅ้ๆๅฎๅฏไธ่ฐๅบฆ่็น๏ผๆจกๆๆบ่ฝไฝ่บซไปฝๆง่กๅจๆ๏ผCron๏ผไธๅฎๆถไปปๅก๏ผๆฏๆไผๅพฎใ้้ใ้ฃไนฆใ้ฎไปถใWebhook ไธ็ซๅ ไฟก (Inbox) ๅค้้ๆบ่ฝ่งฆ่พพ๏ผ่ชๅธฆๆ่ๅ ๅฎนๆธ ๆด๏ผๆญฃๆ็บฏๅๆจ้๏ผไธ่ถ ้ฟๆชๆญไฟๆคใ
- ้ป้ๆฅ่กจๆบ่ฝๅ่ญฆ๏ผๆฏๆ ChatBI ๆฅ่กจๅฎๆถๅทกๆฃ๏ผ้ ็ฝฎ้ๅผๅ่ญฆใๅๅ็ๅ็ฆปใ่ฟ็ปญๅฝไธญไธๆ ๆฐๆฎๅ่ญฆๅนถ่ชๅจๆจ้้็ฅใ
- ๅคๆไพๅๆจกๅ็ฎก็๏ผๅ ็ฝฎ OpenAI, Azure, DeepSeek, Kimi, ๆบ่ฐฑ AI, ็ก ๅบๆตๅจ, ้ฟ้ไบ็พ็ผ, ็ซๅฑฑๅผๆ (Ark/่ฑๅ ), Ollama ็ญๆจกๅ้ข่ฎพไธ Endpoint ๆบ่ฝ็ๆฌๅท่ง่ๅใ
- ๅนณๅฐๆถๅบ้
็ฝฎ๏ผ็ณป็ป่ฐๅบฆๅๆชๅ็ฌๆๅฎๆถๅบ็่ฎข้
ๆ
platform_timezone่งฃ้ๆถ้ด๏ผ้ป่ฎคAsia/Shanghaiใ - ็ฒพ็ปๅ RBAC๏ผ็จๆทใ่ง่ฒใ่ๅไธๅ ็ด ็บงๆ้๏ผ่ฏปๅๆไฝ้็ฆปใ
- SSO ไธ่ฑๆ๏ผSSO ็ปๅฝๅฏๅๅฐๅผๅ ณ๏ผๅฎก่ฎกๆฅๅฟ่ชๅจ่ฑๆๅฏ็ ใAPI Key ็ญๆๆๅญๆฎตใ
- ๅฎๅ จๅฎก่ฎกๆฐดๅฐ๏ผEmbed ็ชๅฃ่ๆฏๆฐดๅฐ๏ผ็จๆทๅ+ๆถ้ดๆณๆ่ชๅฎไนๆๆก๏ผ๏ผ้ฒๆชๅฑๅคๆณใ
- ้พ่ทฏๅฏ่งๅไธๅฏผๅบ๏ผTrace ๆถ้ด็บฟ่ฐ่ฏ๏ผๆฅๆฐ็ปๆ CSV/Excel ๅฏผๅบ๏ผutf-8-sig๏ผใ
๐ ๆบ่ฝไฝๅทฅไฝๆต (Execution Flow)
็ณป็ปๅบๅฑๅบไบ 6 ้ถๆฎตๅผๆญฅๆตๆฐด็บฟ (PipelineRunner) ้ฉฑๅจ๏ผ้ตๅพช ใ็กฎๅฎๅ ฅๅฃ โ ๅงๆดพ/ๅๅ โ ๆง่ก โ ไบคไปใ ้พ่ทฏ๏ผ
- ๅ ฅๅฃ่งฃๆ (Route)๏ผ
agent_id / agent_name / version_id๏ผๆๆญฃๆๅซ @ ๆๅใ่ฟๅ
ฅไธๅฎถๆจกๅผๆถ๏ผ็ด่พพ็ฎๆ ไธๅฎถ๏ผ
- ๅฟซๆทไธ้ป๏ผ็นๅปๆฅๆฐ็ปๆๆไฝ่ถๅๆถ๏ผ่ชๅจ็ด้ ChatBI ๆฐๆฎๆฅ่ฏขไธๅฎถ๏ผ
- ้ป่ฎคๅ
ๅบ๏ผๆชๆๅฎๆถ็ดๆฅๅ ่ฝฝ้ป่ฎคไธปๅฉๆ Main๏ผๅ
ๅปๅคๅฑ้ๅบฆ่ฏญไน่ทฏ็ฑๅผ้๏ผใ
- ๆบ่ฝๅงๆดพ (Delegation)๏ผ
is_system=True) ่ฟๅ
ฅๅงๆดพๅ้ๆฑ ๏ผๆฎ้่ชๅฎไนๆบ่ฝไฝไธๅไธ่ชๅจๅงๆดพ๏ผ๏ผ
- ไธปๅฉๆ็ปๅไปปๅก่ฏๆฑ๏ผๅฏ็ดๆฅไฝ็ญ๏ผๆ่ฐ็จ sub_agent_call๏ผไธฒ่ก๏ผ/ sub_agent_batch_call๏ผๅนถ่ก๏ผๅงๆดพๅญไธๅฎถ๏ผๅ
็ฝฎ้ฒ่ชๅงๆดพใ้ๅฝๆทฑๅบฆไธๆ้ๅฎๅ
จ้จ็ฆใ
- ๆง่กๅๅ (Dispatcher)๏ผ
- ๅจๆๆง่ก (ReAct)๏ผ
- ็ปๆไบคไปไธๅๆ (Synthesis)๏ผ
่ฏฆ่ง architech/design/chat/CHAT_FLOW.md ยท ๆบ่ฝๅงๆดพไธไธๅฎถ็ด้่ฎพ่ฎก
๐ ๆๆกฃไธๆถๆ (Documentation)
| ๆๆกฃ | ่ฏดๆ |
| ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |
| ๅพฎไฟกๅฎๆ่ฟ่ฝฝ | ๆถๆๅๅฑใๅฎ่ฃ
้จ็ฝฒใๆบ่ฝไฝ้
็ฝฎใChatBIใๅทฅๅ
ท็ฎฑใMCP |
| HOW_TO_INSTALL.md | ๅฎ่ฃ
้จ็ฝฒไธ FAQ |
| architech/README.md | ๆถๆๆๆกฃ็ดขๅผ |
| CHAT_FLOW.md | ่ๅคฉ็ซฏๅฐ็ซฏๆต็จ |
| PROMPT_LAYERS.md | ๆ็คบ่ฏๅๅฑไธๆณจๅ
ฅ |
| AGENT_ROUTING_DESIGN.md | ๆบ่ฝๅงๆดพไธไธๅฎถ็ด้่ฎพ่ฎก |
| mcp-business-integration-authentication-design.md | MCP ไธๅก้ๆ่ฎค่ฏๆปไฝๆถๆใๅฎๅ
จ็ญ็ฅไธ่ฐ็จๆต็จ |
| mcp-platform-inbound-service-design.md | NanZi ๅนณๅฐ็บง MCP ๅฏนๅคๆๅกใOAuth2 ๆๆใ็ฎก็้กตไธๅ
ๆฐๆฎๆนๆณๆนๆก |
| api_integration_guide.md | Embed / V1 API ้ๆ |
| mcp_user_context_integration_guide.md | ่ชๆ MCP UserContext ๆฅๅ
ฅใJWKS ้ช็ญพๅ Python / Java ็คบไพ |
| mcp_echo_test_server.md | ๅนณๅฐ็บง MCP Echo ๆต่ฏๆๅกๅๅปบใๆบ่ฝไฝๆ่ฝฝไธ่ฎค่ฏ่ฏๆญ |
| code_canvas_and_workspace_guide.md | ไปฃ็ ็ปๅธใๅทฅไฝๅบๆไปถไธๆง่ก API |
| sandbox/docker/README.md | Docker ๅฎๅ
จๆฒ็ฎฑ้ขๆๅปบไธ่ฟ็ปดๆๅ๏ผๅซๆ้ๅทฅๅ
ท้พใ--dry-run ไธ --list๏ผ |
| sandbox/k8s/README.md | K8s ๆฒ็ฎฑ้ข็ฝฎ้ๅๆๅปบไธ่ฟ็ปดๆๅ๏ผๅทๅฏๅจๅ ้ใk8s_deploy ่ฟ็ปดไธ็ๆง๏ผ |
| FAQ 7.3.7 SSH ๆฒ็ฎฑ่ฟ่กๅๆๆกไปถไธ่ฟๆฅๆๆฅ | SSH ๆฒ็ฎฑ๏ผssh ็ญ็ฅ๏ผsshpass / openssh-client / known_hosts ๅ็ฝฎไพ่ตไธๆฅ้ๅฏน็
ง |
| ai_agent_gating_contract.md | Agent ้จๆงๅฅ็บฆ |
| tests/CHECKLIST.md | ่ชๅจๅๆต่ฏ้ชๆถๆธ
ๅ |
๐ ้กน็ฎ็ปๆ (Structure)
.
โโโ app/ # ๅ็ซฏๆ ธๅฟไปฃ็ (FastAPI ๅผๆญฅๆถๆ)
โ โโโ api/ # API ่ทฏ็ฑๅฑ (Portal ่ฟ่ฅ็ซฏไธ V1 ๅฎขๆท็ซฏ REST/SSE ๆฅๅฃ)
โ โโโ core/ # ็ณป็ปๆ ธๅฟๅบ็ก่ฎพๆฝ (ๅ
จๅฑ้
็ฝฎใๆฐๆฎๅบๅผๆใๅฎๅ
จๅ ๅฏใ็ๅฝๅจๆ)
โ โโโ models/ # SQLAlchemy 2.x ๆฐๆฎๅบ ORM ๅฎไฝๆจกๅ
โ โโโ schemas/ # Pydantic ๅฅ็บฆไธ DTO ๆฐๆฎๆ ก้ชๆจกๅ
โ โโโ services/ # ๆ ธๅฟไธๅกๆๅกๅฑ (้ดๆใๆจกๅ็ฎก็ใChatBIใRAGใMCP ่ฐๅบฆ)
โ โ โโโ ai/ # ๐ค AI ็ผๆไธญๅฟ (AgentScope ่ฟ่กๅจใOpenClaw ๆง่กๅจใๆๅพๅๅๅจ)
โ โโโ utils/ # ้็จๅทฅๅ
ทๅบ (ๅ ่งฃๅฏใๅ้็ฎๅญใๆฐๆฎ่ฝฌๆขไธ่พ
ๅฉๅทฅๅ
ท)
โโโ frontend/ # ๅ็ซฏๅทฅ็จ (Vue 3 + Vite + TypeScript + Tailwind CSS)
โ โโโ src/
โ โโโ api/ # ๅ็ซฏๆฅๅฃ่ฏทๆฑๅฑไธๅ็ซฏๅฅ็บฆๆ ๅฐ
โ โโโ views/ # ไธๅก้กต้ข (ๆงๅถๅฐใๆบ่ฝไฝ็ผๆใChatBIใ็ฅ่ฏๅบใๆ่ฝไธญๅฟ็ญ)
โ โโโ components/ # ้็จ UI ็ปไปถไธ่ๅคฉๆตๅผๅก็
โ โโโ composables/ # Vue ็ปๅๅผ็ถๆ้ป่พ (SSE ๆตๅผไผ่ฏใๆ้็ฎก็)
โ โโโ router/ # ๅจๆ่ทฏ็ฑไธ่ๅๆ้ๆงๅถ
โโโ .agent/ # Agent ่ชๅจๅๅผๅๆ่ฝไธๅทฅไฝๆตไฝ็ณป (opsxใdev-skills ็ญ)
โโโ architech/ # ้กถๅฑๆถๆ่ฎพ่ฎกใๅฅ็บฆ่ง่ไธ็ณป็ปๆ็คบ่ฏ (Prompts) ็ฎก็ไธญๅฟ
โโโ data/ # ๅนณๅฐๆไน
ๅ่ฟ่กๆฐๆฎ (ๅทฅไฝๅบใๆฒ็ฎฑ่ฟ่กๆถใๆ่ฝ่ตไบงใๆไปถไธไผ )
โโโ db-prod/ # MySQL ๅๅฒ็ๆฌ่ฟ็งปไธ SQL ๅ็บง่ๆฌ (V0-VNN)
โโโ db-prod-pg/ # PostgreSQL ๅบ็บฟไธๅน็ญ็ๆฌ่ฟ็งปไฝ็ณป (V0-VNN)
โโโ docker/ # ๅฎนๅจๅ้ๅๆๅปบๆนๆกไธ docker-compose ไธ้ฎๅฏๅจ็ผๆ
โโโ docs/ # ้กน็ฎๆถๆๆๆกฃใๅๅธ่ฎฐๅฝ (Release Notes) ไธๅ็่ฎพ่ฎก่ง่
โโโ html/ # ๅนณๅฐๅ้กตไบงๅ่ฝๅฐๅฎฃไผ ้กต (Landing Page)
โโโ k8s_deploy/ # ไบๅ็็ไบง็บง Kubernetes ็ผๆๆธ
ๅไธๆฒ็ฎฑ้็ฆป้็พค่ฟ็ปดๅฅไปถ
โโโ sandbox/ # ๐ฆ ่ฟ่กๆถไปฃ็ ๆฒ็ฎฑ่ฟ็ปด็ฎๅฝ (docker/k8s)
โโโ scripts/ # ่ฟ็ปด/ๅผๅ่พ
ๅฉ่ๆฌ (ไธ้ฎๅผๅๅฏๅจใๆฐๆฎๅๆญฅใ้้จ็ฝฒๅทฅๅ
ท)
โโโ tests/ # ่ชๅจๅๆต่ฏๅฅไปถ (Pytest) ไธๆต่ฏ้ชๆถๆธ
ๅ (CHECKLIST.md)
โโโ dev.sh # ๐ ๏ธ ๆฌๅฐไธ้ฎๅผๅๅฏๅจใ็ญ็ผ่ฏไธๅๅ็ซฏ่ฟ็จๅฏๅ่ฟ็ปด่ๆฌ
โโโ env.example # โ๏ธ ๅ
จๅฑ็ฏๅขๅ้ไธ็ณป็ปๆ ธๅฟๆๆ้
็ฝฎ็คบไพๆจกๆฟ
โโโ requirements.txt # ๐ฆ ๅ็ซฏ Python ๆ ธๅฟ่ฟ่กๆถไพ่ตๆธ
ๅ (Python 3.11)
โโโ pytest.ini # ๐งช ่ชๅจๅๆต่ฏๅฅไปถ่ฟ่กไธๆญ่จ้
็ฝฎ๐ ๆ น็ฎๅฝๅ ณ้ฎ่ๆฌไธ้ ็ฝฎๆไปถ่ฏดๆ
| ๆไปถ | ็ฑปๅ | ๆ ธๅฟ่่ดฃ่ฏดๆ |
| :-------------------------------------------- | :--------- | :------------------------------------------------------------------------------------------------------------------------------ |
| dev.sh | Shell ่ๆฌ | ๆฌๅฐไธ้ฎๅผๅ่ฟ็ปดๆปๆง๏ผๆฏๆๅๅ็ซฏๅนถ่กๅฏๅจใ็ญ็ผ่ฏ้่ฝฝใๅๅฐ/ๅๅฐ่ฟ่กๆจกๅผๅๆขใ็ฏๅขๆขๆตไธ่ฟ็จไผ้
ๅฏๅใ |
| sandbox/docker/build-docker-sandbox-image.sh | Shell ่ๆฌ | Docker ไปฃ็ ๅฎๅ
จๆฒ็ฎฑ้ขๆๅปบ๏ผๆๅๆๅๅนถๆๅปบๅธฆๅฎๅ
จ้็ฆป็ Python 3.11 ๆฒ็ฎฑ้ๅ๏ผๅคงๅน
ๅ ้ Agent ๅจๆๆง่กไปฃ็ ๆถ็ๅฏๅจ้ๅบฆใ |
| env.example | ้
็ฝฎๆจกๆฟ | ๅ
จๅฑ็ฏๅขๅ้ๅบๅๆจกๆฟ๏ผๅ
ๅซ MySQL/PostgreSQLใRedis StackใJWT/ๅ ๅฏ็ง้ฅใๆจกๅ API ็ซฏ็น็ญๆ ธๅฟ่ฟ่กๅๆฐใ |
| requirements.txt | ไพ่ต้
็ฝฎ | ๅ็ซฏ่ฟ่กๆถไพ่ตๅ
ๆธ
ๅ๏ผๅบไบ Python 3.11 ็ๆ ธๅฟ็ฌฌไธๆนๅบไพ่ตๅฎไน๏ผFastAPIใAgentScopeใSQLAlchemyใRedis ็ญ๏ผใ |
| pytest.ini | ๆต่ฏ้
็ฝฎ | ่ชๅจๅๆต่ฏๅฅไปถ้
็ฝฎ๏ผๅฎไน Pytest ็จไพ่ฟๆปค่งๅใๅผๆญฅๆ ่ฎฐใๆงๅถๅฐๆฅๅฟ่พๅบไธๆต่ฏ่ฟ่ก่กไธบใ |
๐ ๅฟซ้ๅผๅง
๐ณ Docker ้จ็ฝฒ (ๆจ่)
1. ้ ็ฝฎ็ฏๅข
cd docker
cp ../env.example .env # ้
็ฝฎๆฐๆฎๅบใRedisใENCRYPTION_KEY ็ญๅนณๅฐไธปๅบ้ป่ฎคไฝฟ็จ MySQL๏ผๅฆ้ไฝฟ็จ PostgreSQL๏ผ็ผ่พ docker/.env๏ผ
DATABASE_TYPE=postgresql
POSTGRES_HOST=host.docker.internal
POSTGRES_PORT=5432
POSTGRES_DB=nanzi_ai_agent_platform
POSTGRES_USER=postgres
POSTGRES_PASSWORD=<password>ๅฎนๅจไธญ็ไธปๅบ Host ไธ่ฝๅกซๅ localhost ๆ 127.0.0.1๏ผๅบไฝฟ็จๅฎฟไธปๆบๅฐๅใ
host.docker.internal ๆ Docker ็ฝ็ปไธญ็ๆๅกๅใ่ฏฆ็ปๅๅงๅๆญฅ้ชค่ง
HOW_TO_INSTALL.md ๅ db-prod-pg/README.mdใ
ไธปๅบๅๅงๅ
MySQL ไฝฟ็จ db-prod/apply-sql.sh๏ผPostgreSQL ไฝฟ็จ็ฌ็ซ็ๅน็ญ่ฟ็งปๅ
ฅๅฃ๏ผ
# ่ฟๅ้กน็ฎๆ น็ฎๅฝๆง่ก
cd ..
./db-prod-pg/apply-sql.sh่ฏฅ่ๆฌไผๆ db-prod-pg/ ไธญๅฝๅๅญๅจ็ V0๏ฝV14 ็ๆฌ้กบๅบๆง่ก PostgreSQL ่ฟ็งป๏ผๅนถๅจ้ฆๆฌกๅๅงๅๅ่ฏข้ฎๆฏๅฆๅๅปบ็ฎก็ๅใไปฅๅๆฐๅข่ฟ็งปๆถ๏ผไปฅ่ฏฅ็ฎๅฝๅฎ้
ๆไปถไธบๅ๏ผไธ่ฆๆ PostgreSQL ่ฟ็งปๅ db-prod/ ็ MySQL ่ฟ็งปๆทท็จใ
PostgreSQL ไธไฝฟ็จ MySQL ็ INIT-USER-ADMIN.sql ๅบๅฎๅญ่ฏ๏ผๅฆ้ๆๅจ็ปดๆค็ฎก็ๅ๏ผๅฏๆง่ก๏ผ
./db-prod-pg/create-admin-user.sh
./db-prod-pg/create-admin-key.sh
./db-prod-pg/reset-admin-password.sh2. ๆๅปบ้ๅๅนถๅฏผๅบ tar
| ่ๆฌ | ็ฎๆ ็ฏๅข |
| :----------------------- | :------------------------------ |
| ./build_linux_x86.sh | x86_64 Linux ๆๅกๅจ๏ผๆๅธธ่ง๏ผ |
| ./build_linux_arm.sh | ARM64 Linux๏ผ้ฒฒ้น / Ampere ็ญ๏ผ |
| ./build_native.sh | ๆฌๆบๅ็ๆถๆ๏ผไป
็จไบๆฌๅฐ่ฏ่ท |
# ่ฅไธไธๆญฅ่ฟๅไบ้กน็ฎๆ น็ฎๅฝ๏ผๅ
่ฟๅ
ฅ docker ็ฎๅฝ
cd docker
็ไบง็ฏๅข๏ผx86 ๆๅกๅจ๏ผโ Mac ไธๆ x86 ๅ
ไน็จๆญค่ๆฌ
./build_linux_x86.shไบง็ฉ่พๅบ่ณ docker/release/๏ผไพๅฆ nanzi-ai-agent_linux-amd64_20250527.tarใ็ฆป็บฟ้จ็ฝฒๅฏๅจ็ฎๆ ๆบๆง่ก docker load -i docker/release/xxx.tarใ
Mac๏ผApple Silicon๏ผ้จ็ฝฒๅฐ x86 ๆๅกๅจๆถ๏ผๅกๅฟ ไฝฟ็จbuild_linux_x86.sh๏ผไธ่ฆ็จbuild_native.shใ้ฆๆฌก่ทจๅนณๅฐๆๅปบๆๅๅบ็ก้ๅๆถๅฏ่ฝ่พ้ฟๆถ้ดๆ ๆฐๆฅๅฟ๏ผๅฑๆญฃๅธธ็ฐ่ฑกใ
่ฅๆ็คบ docker buildx ไธๅฏ็จ๏ผHomebrew docker + Colima ๅธธ่ง๏ผcli-plugins ไปๆๅๅทฒๅธ่ฝฝ็ Docker Desktop๏ผ๏ผ
cd docker
./install-buildx.sh
./build_linux_x86.sh่ฏฆ่ง docker/README.md ยท docker/README_EN.md
3. ๅฏๅจๆๅก
./start-nanzi-ai-agent.sh๐ ๏ธ ๅผๅไธ้จ็ฝฒๅทฅๅ ท
1. ๆฌๅฐไธ้ฎๅผๅ่่ฐ (ๅผบ็ๆจ่)
ๅฏนไบๆฅๅธธๆฌๅฐๅผๅ๏ผๆจ่ไฝฟ็จ้กน็ฎๆ น็ฎๅฝไธ็ไธ้ฎ้ๆ่ๆฌ๏ผ
./dev.sh่ฏฅ่ๆฌ้ฆๆฌก่ฟ่กไผ่ชๅจๆฃๆตๅนถๅฎ่ฃ
uv๏ผๅๅค Python 3.11ใๅๅปบ .venv ๅนถๅฎ่ฃ
ๅ็ซฏไพ่ต๏ผๅ็ปญไป
ๅจ requirements.txt ๅๅๆถๆดๆฐไพ่ตใ้ๅ่ๆฌไผๅๆญขๆง็ API_SERVICE_PORT ่ฟ็จ๏ผ้ป่ฎค็ซฏๅฃ 8001๏ผใ็ผ่ฏๅ็ซฏ๏ผ่ทณ่ฟ็ฑปๅๆฃๆฅไปฅๆ้๏ผๅนถไปฅๅๅฐ reload ๆจกๅผๆ่ตทๅ็ซฏ FastAPI ๆๅก๏ผๆจๅฏไปฅๅจๅฝๅ็ป็ซฏไธญๅฎๆถๆฅ็่่ฐๆฅๅฟไธ่พๅบใ
ๅฆ้ๅๅฐ่ฟ่ก๏ผๅฏไฝฟ็จไปฅไธ็ๅฝๅจๆๅฝไปค๏ผ
# ๅๅฐๅฏๅจ๏ผPID ไฟๅญๅฐ .dev-server.pid
./dev.sh -d
ๆฅ็ PIDใ็ซฏๅฃ็ๅฌๅ /health ๅฅๅบท็ถๆ
./dev.sh status
ไผ้
ๅๆญขๅๅฐๆๅก๏ผ่ถ
ๆถๅ่ชๅจๅผบๅถๅๆญข
./dev.sh stopstatus ๅ stop ไธไผ้ๆฐๅฎ่ฃ
ไพ่ตๆ็ผ่ฏๅ็ซฏ๏ผ็ซฏๅฃ็ๅฌๆขๆตไผๅ
ไฝฟ็จ lsof๏ผ็ผบๅคฑๆถ่ชๅจๅ้ๅฐ ss/fuserใ่ๆฌๅฏ่ฏๅซไปฅ็ปๅฏน/็ธๅฏน .venv ่ทฏๅพๆ python3 -m uvicorn ็ญๅฝขๆๅฏๅจ็ๆฌ้กน็ฎ Uvicorn๏ผ่ฅไปๆ ๆณ็กฎ่ฎคๅฝๅฑ๏ผๆ็กฎๅฎ่ขซๅ
ถไป่ฟ็จๅ ็จ๏ผ๏ผไผๅๅบ็ๅฌ PID ๅๅฝไปค่กๅนถๆ็ป่ฏฏๆ๏ผไพฟไบไบบๅทฅๆ ธๅฏนใ
ๅฏๅจ้กถ้จ่ฟไผๆๅฐ uvใPython ็ฎๆ ็ๆฌใ่ๆ็ฏๅขใPyPI ้ๅใDATABASE_TYPEใๆฐๆฎๅบๅฐๅๅ Redis ๅฐๅ็ญ้
็ฝฎๆ่ฆ๏ผๆฐๆฎๅบๅ Redis ๅฏ็ ไธไผๅ็ฌๆๅฐใ่ฟไบไฟกๆฏไป
็จไบ็กฎ่ฎคๅฝๅ้
็ฝฎ๏ผไธไปฃ่กจๆฐๆฎๅบๆ Redis ่ฟ้ๆงๆต่ฏๅทฒ็ป้่ฟใ
่ฟ่กๅ็็ฏๅขๅๅค๏ผ.env๏ผ๏ผ่ๆฌ้ฆๆฌก่ฟ่กๅๅฟ ้กปๅ ็ผ่พ.env้ ็ฝฎๆไปถใ้กน็ฎๆ น็ฎๅฝๆไพไบๆจกๆฟenv.example๏ผ่ฏทๅ ๅบไบๅฎๅๅปบ.envๅนถๅกซๅไธบไฝ ็ๅฎ้ ็ฏๅข๏ผ
>>> cp env.example .env
> ็ถๅๆ้ไฟฎๆน .env ไธญ็ๅ
ณ้ฎ้กน๏ผ
> - ๆฐๆฎๅบ๏ผDATABASE_TYPE๏ผmysql้ป่ฎค /postgresql๏ผ๏ผไปฅๅๅฏนๅบ็MYSQL_ๆPOSTGRES_ไธปๆบใ็ซฏๅฃใๅบๅใ่ดฆๅทไธๅฏ็ ๏ผ
- Redis๏ผREDIS_HOSTใREDIS_PORTใREDIS_DBใREDIS_PASSWORD๏ผๆ ๅฏ็ ๆถ็็ฉบ๏ผ๏ผ
- ไปปๅก่ฐๅบฆ๏ผTASK_SCHEDULER_ENABLED๏ผ้ป่ฎคtrue๏ผ๏ผๅค่็น้จ็ฝฒๆถๅชๅจไธไธช่็นๅผๅฏ๏ผๅ ถไป API ่็น่ฎพไธบfalse๏ผ
- ๅ ๅฏๅฏ้ฅ๏ผENCRYPTION_KEY๏ผAPI Key ็ๅฏน็งฐๅ ๅฏๅฏ้ฅ๏ผๅฏไฟ็ๆจกๆฟ้ป่ฎคๅผ๏ผ็ไบง็ฏๅขๅกๅฟ
ๆดๆขไธบ็ฌ็ซ็ Fernet Key๏ผ๏ผ
- ๅฏ้้ๆ๏ผSSOใRAGFlowใJira ็ญไฟกๆฏๆ้ๅกซๅใ
ไธ้ฎ่ๆฌไป้่ฆๆฌๆบๅ
ทๅค Node.js/npm๏ผๅนถไธ้่ฆๆๅๅๅค .envใๆฐๆฎๅบๅ Redis๏ผuvใPython ไธ Python ไพ่ต็้ฆๆฌกไธ่ฝฝ้่ฆ็ฝ็ปใ่ฅ PyPI ้ๅ้่ฆ่ฐๆด๏ผๅฏ้่ฟ PYPI_INDEX_URL ่ฆ็้ป่ฎค็ๆธ
ๅ้ๅๅฐๅใ
๐ค ่ดก็ฎๆๅ
- ๅๆฏ่ง่: ๅบไบ
mainๅๆฏๅผๅ๏ผๅ่ฝๅๆฏๅฝๅๆ ผๅผfeature/your-feature-nameใ - ๆไบคไฟกๆฏ: ๅฟ ้กปไฝฟ็จ ไธญๆ ็ผๅ Commit Message๏ผๆธ ๆฐๆ่ฟฐๅๆดๅ ๅฎนใ
- ๆต่ฏ้ชๆถ: ๆฐๅขๅ่ฝๆถ๏ผ่ฏทๆดๆฐ
tests/CHECKLIST.mdใ
๐ฌ ่็ณปไธไบคๆต
ๅฆๆๆจๅจไฝฟ็จ่ฟ็จไธญๆไปปไฝ็้ฎใๅ่ฝๅปบ่ฎฎ๏ผๆ่ ๆณ่ฆ่ทๅๆดๅคๆๆฏ่ต่ฎฏ๏ผๆฌข่ฟๆซ็ ๅ ณๆณจๆไปฌ็ๅพฎไฟกๅ ฌไผๅท๏ผๆๅ ๅ ฅๅพฎไฟกไบคๆต็พค๏ผไบฆๅฏ้ ่ฏป NanZi ๅผๆบๆบ่ฝไฝๅนณๅฐๅฎๆ่ฟ่ฝฝ๏ผ
 ๅพฎไฟกๅ ฌไผๅท |
 ๅพฎไฟกไบคๆต็พค๏ผ7ๅคฉๅ ๆๆ๏ผ |
ๆซ็ ่ฟ็พค่ทๅๅนณๅฐๅ ่ดนไฝ้ช่ดฆๅทๅๅฐๅใ
๐ ๆฏๆไธ่ต่ต
NanZi AI ๆบ่ฝไฝๅนณๅฐๆฏไธไธชๅฎๅ จๅผๆบไธๆ็ปญ่ฟญไปฃๆผ่ฟ็้กน็ฎใๅฆๆๆฌ้กน็ฎๅจๅญฆไน ใๅทฅไฝๆไธๅก่ฝๅฐไธญๅฏนๆจๆๆๅธฎๅฉ๏ผๆฌข่ฟ่ฏทไฝ่ ๅๆฏๅๅก โ๏ผ
ๆจ็ๆฏไธไปฝๆฏๆ๏ผ้ฝๆฏๆฟๅฑ้กน็ฎๆ็ปญๆ็ฃจๆถๆใๆฉๅฑๆ ธๅฟๅ่ฝไธ็ปดๆค้ซ่ดจ้ๆๆกฃ็ๅทจๅคงๅจๅใ่กทๅฟๆ่ฐขๆๆๆฏๆๅผๆบ็ๅฐไผไผด๏ผ
ๅพฎไฟก่ต่ตๆฏๆ๏ผไฝ่ NanZi๏ผ
๐ ่ฎธๅฏ่ฏ
ๆฌ้กน็ฎ้็จ MIT ๅผๆบ่ฎธๅฏ่ฏ๏ผๅ ่ฎธ่ช็ฑไฝฟ็จใๅคๅถใไฟฎๆนใๅๅนถใๅๅธใๅๅใๅ่ฎธๅฏๅ้ๅฎๆฌ่ฝฏไปถๅฏๆฌใ
Copyright ยฉ 2025-2026 Randy Chen