[{"data":1,"prerenderedAt":1541},["ShallowReactive",2],{"blog-post-/blogs/agentscope-2-production":3},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"image":11,"alt":12,"ogImage":11,"tags":13,"published":18,"body":19,"_type":1534,"_id":1535,"_source":1536,"_file":1537,"_stem":1538,"_extension":1539,"sitemap":1540},"/blogs/agentscope-2-production","blogs",false,"","AgentScope 2.0 正式发布：让 AI Agent 真正能在生产环境中跑起来","从实验性框架到生产级平台，AgentScope 2.0 的七大核心升级直击 AI Agent 落地痛点。","2026-05-28","/blogs-img/agentscope-2-production.jpg","AI Agent 生产环境部署手帐插画",[14,15,16,17],"AI Agent","AgentScope","开源","多智能体",true,{"type":20,"children":21,"toc":1517},"root",[22,34,38,43,48,51,58,63,119,127,130,136,143,148,167,172,178,199,301,311,317,329,347,352,358,370,462,467,473,478,483,562,572,578,590,626,638,644,649,654,714,760,768,771,777,782,993,1001,1004,1010,1090,1093,1099,1104,1248,1253,1276,1281,1306,1314,1317,1323,1328,1344,1368,1378,1388,1397,1400,1405,1417,1455,1463,1468,1471,1479,1511],{"type":23,"tag":24,"props":25,"children":26},"element","blockquote",{},[27],{"type":23,"tag":28,"props":29,"children":30},"p",{},[31],{"type":32,"value":33},"text","从\"能聊天\"到\"能干活\"，这一次升级直击 AI Agent 落地的核心痛点。",{"type":23,"tag":35,"props":36,"children":37},"hr",{},[],{"type":23,"tag":28,"props":39,"children":40},{},[41],{"type":32,"value":42},"就在刚刚，AgentScope 2.0 发布了：这次是一个大版本更新，这标志着AgentScope已经从实验性框架，蜕变为真正能在生产环境中稳定运行的 Agent 平台。我觉得这次真的可以全面对标LangChain生态了。",{"type":23,"tag":28,"props":44,"children":45},{},[46],{"type":32,"value":47},"我也很快就上手体验了一番。",{"type":23,"tag":35,"props":49,"children":50},{},[],{"type":23,"tag":52,"props":53,"children":55},"h2",{"id":54},"为什么需要-20",[56],{"type":32,"value":57},"为什么需要 2.0？",{"type":23,"tag":28,"props":59,"children":60},{},[61],{"type":32,"value":62},"如果你用过 AgentScope 1.0 或其他 Agent 框架，一定经历过这些痛点：",{"type":23,"tag":64,"props":65,"children":66},"ul",{},[67,79,89,99,109],{"type":23,"tag":68,"props":69,"children":70},"li",{},[71,77],{"type":23,"tag":72,"props":73,"children":74},"strong",{},[75],{"type":32,"value":76},"模型调用了，但报错了怎么办？",{"type":32,"value":78}," 没有自动重试机制，任务直接中断",{"type":23,"tag":68,"props":80,"children":81},{},[82,87],{"type":23,"tag":72,"props":83,"children":84},{},[85],{"type":32,"value":86},"Agent 在后台跑，用户完全不知道发生了什么",{"type":32,"value":88}," 黑盒执行，出了问题无从下手",{"type":23,"tag":68,"props":90,"children":91},{},[92,97],{"type":23,"tag":72,"props":93,"children":94},{},[95],{"type":32,"value":96},"Agent 拿到了文件读写权限，结果误删了重要数据",{"type":32,"value":98}," 权限控制太粗粒度",{"type":23,"tag":68,"props":100,"children":101},{},[102,107],{"type":23,"tag":72,"props":103,"children":104},{},[105],{"type":32,"value":106},"对话长了之后，上下文爆炸",{"type":32,"value":108}," 模型开始胡言乱语",{"type":23,"tag":68,"props":110,"children":111},{},[112,117],{"type":23,"tag":72,"props":113,"children":114},{},[115],{"type":32,"value":116},"开发时跑在本地，部署时要改一堆代码适配云端",{"type":32,"value":118}," 环境切换痛苦",{"type":23,"tag":28,"props":120,"children":121},{},[122],{"type":23,"tag":72,"props":123,"children":124},{},[125],{"type":32,"value":126},"AgentScope 2.0 的七个核心更新，全部瞄准这些问题。",{"type":23,"tag":35,"props":128,"children":129},{},[],{"type":23,"tag":52,"props":131,"children":133},{"id":132},"七大核心特性逐个击破生产难题",[134],{"type":32,"value":135},"七大核心特性，逐个击破生产难题",{"type":23,"tag":137,"props":138,"children":140},"h3",{"id":139},"_1-模型自动重试-备用模型切换",[141],{"type":32,"value":142},"1. 模型自动重试 + 备用模型切换 🔄",{"type":23,"tag":28,"props":144,"children":145},{},[146],{"type":32,"value":147},"生产环境中，模型 API 偶尔超时、限流、返回异常是常态。",{"type":23,"tag":28,"props":149,"children":150},{},[151,153,158,160,165],{"type":32,"value":152},"AgentScope 2.0 内置了",{"type":23,"tag":72,"props":154,"children":155},{},[156],{"type":32,"value":157},"自动重试机制",{"type":32,"value":159},"，并且支持",{"type":23,"tag":72,"props":161,"children":162},{},[163],{"type":32,"value":164},"备用模型切换",{"type":32,"value":166},"。当主模型不可用时，自动降级到备用模型，保证任务不中断。",{"type":23,"tag":28,"props":168,"children":169},{},[170],{"type":32,"value":171},"这意味着什么？你的 Agent 不会再因为一次网络抖动就挂掉。",{"type":23,"tag":137,"props":173,"children":175},{"id":174},"_2-执行过程实时可见可交互可干预-️",[176],{"type":32,"value":177},"2. 执行过程实时可见、可交互、可干预 👁️",{"type":23,"tag":28,"props":179,"children":180},{},[181,183,188,190,197],{"type":32,"value":182},"不再是黑盒执行。2.0 引入了",{"type":23,"tag":72,"props":184,"children":185},{},[186],{"type":32,"value":187},"事件驱动的流式架构",{"type":32,"value":189},"（",{"type":23,"tag":191,"props":192,"children":194},"code",{"className":193},[],[195],{"type":32,"value":196},"agent.reply_stream",{"type":32,"value":198},"），通过 SSE（Server-Sent Events）实时推送：",{"type":23,"tag":64,"props":200,"children":201},{},[202,230,249,275],{"type":23,"tag":68,"props":203,"children":204},{},[205,207,213,215,221,222,228],{"type":32,"value":206},"文本生成进度（",{"type":23,"tag":191,"props":208,"children":210},{"className":209},[],[211],{"type":32,"value":212},"TextBlockStart",{"type":32,"value":214}," → ",{"type":23,"tag":191,"props":216,"children":218},{"className":217},[],[219],{"type":32,"value":220},"TextBlockDelta",{"type":32,"value":214},{"type":23,"tag":191,"props":223,"children":225},{"className":224},[],[226],{"type":32,"value":227},"TextBlockEnd",{"type":32,"value":229},"）",{"type":23,"tag":68,"props":231,"children":232},{},[233,235,241,242,248],{"type":32,"value":234},"模型调用状态（",{"type":23,"tag":191,"props":236,"children":238},{"className":237},[],[239],{"type":32,"value":240},"ModelCallStart",{"type":32,"value":214},{"type":23,"tag":191,"props":243,"children":245},{"className":244},[],[246],{"type":32,"value":247},"ModelCallEnd",{"type":32,"value":229},{"type":23,"tag":68,"props":250,"children":251},{},[252,254,260,261,267,268,274],{"type":32,"value":253},"工具调用过程（",{"type":23,"tag":191,"props":255,"children":257},{"className":256},[],[258],{"type":32,"value":259},"ToolCallStart",{"type":32,"value":214},{"type":23,"tag":191,"props":262,"children":264},{"className":263},[],[265],{"type":32,"value":266},"ToolCallDelta",{"type":32,"value":214},{"type":23,"tag":191,"props":269,"children":271},{"className":270},[],[272],{"type":32,"value":273},"ToolCallEnd",{"type":32,"value":229},{"type":23,"tag":68,"props":276,"children":277},{},[278,280,286,287,293,294,300],{"type":32,"value":279},"思考链展示（",{"type":23,"tag":191,"props":281,"children":283},{"className":282},[],[284],{"type":32,"value":285},"ThinkingBlockStart",{"type":32,"value":214},{"type":23,"tag":191,"props":288,"children":290},{"className":289},[],[291],{"type":32,"value":292},"ThinkingBlockDelta",{"type":32,"value":214},{"type":23,"tag":191,"props":295,"children":297},{"className":296},[],[298],{"type":32,"value":299},"ThinkingBlockEnd",{"type":32,"value":229},{"type":23,"tag":28,"props":302,"children":303},{},[304,309],{"type":23,"tag":72,"props":305,"children":306},{},[307],{"type":32,"value":308},"用户可以实时看到 Agent 在做什么，甚至在运行中进行干预。",{"type":32,"value":310}," 这才是真正的 Human-in-the-loop。",{"type":23,"tag":137,"props":312,"children":314},{"id":313},"_3-细粒度权限系统高风险操作自动拦截",[315],{"type":32,"value":316},"3. 细粒度权限系统，高风险操作自动拦截 🔒",{"type":23,"tag":28,"props":318,"children":319},{},[320,322,327],{"type":32,"value":321},"AgentScope 2.0 引入了",{"type":23,"tag":72,"props":323,"children":324},{},[325],{"type":32,"value":326},"权限上下文（Permission Context）",{"type":32,"value":328},"，支持：",{"type":23,"tag":64,"props":330,"children":331},{},[332,337,342],{"type":23,"tag":68,"props":333,"children":334},{},[335],{"type":32,"value":336},"不同操作设置不同权限级别",{"type":23,"tag":68,"props":338,"children":339},{},[340],{"type":32,"value":341},"高风险操作（如文件删除、系统命令执行）自动拦截，等待用户确认",{"type":23,"tag":68,"props":343,"children":344},{},[345],{"type":32,"value":346},"动态调整权限策略，无需修改核心代码",{"type":23,"tag":28,"props":348,"children":349},{},[350],{"type":32,"value":351},"这让 Agent 在获得强大能力的同时，不会变成\"脱缰野马\"。",{"type":23,"tag":137,"props":353,"children":355},{"id":354},"_4-长任务上下文结构化管理",[356],{"type":32,"value":357},"4. 长任务上下文结构化管理 📚",{"type":23,"tag":28,"props":359,"children":360},{},[361,363,368],{"type":32,"value":362},"对话长了怎么办？2.0 通过 ",{"type":23,"tag":72,"props":364,"children":365},{},[366],{"type":32,"value":367},"Session 机制",{"type":32,"value":369},"实现了上下文的精细化管理：",{"type":23,"tag":371,"props":372,"children":376},"pre",{"className":373,"code":374,"language":375,"meta":7,"style":7},"language-python shiki shiki-themes dracula","# 创建 Agent\nPOST /agent/\n\n# 创建 Session（绑定模型配置、Workspace）\nPOST /sessions/\n\n# 开始对话（流式响应）\nPOST /chat/\nBody: {\"agent_id\": \"...\", \"session_id\": \"...\", \"input\": \"...\"}\n","python",[377],{"type":23,"tag":191,"props":378,"children":379},{"__ignoreMap":7},[380,391,400,409,418,427,435,444,453],{"type":23,"tag":381,"props":382,"children":385},"span",{"class":383,"line":384},"line",1,[386],{"type":23,"tag":381,"props":387,"children":388},{},[389],{"type":32,"value":390},"# 创建 Agent\n",{"type":23,"tag":381,"props":392,"children":394},{"class":383,"line":393},2,[395],{"type":23,"tag":381,"props":396,"children":397},{},[398],{"type":32,"value":399},"POST /agent/\n",{"type":23,"tag":381,"props":401,"children":403},{"class":383,"line":402},3,[404],{"type":23,"tag":381,"props":405,"children":406},{"emptyLinePlaceholder":18},[407],{"type":32,"value":408},"\n",{"type":23,"tag":381,"props":410,"children":412},{"class":383,"line":411},4,[413],{"type":23,"tag":381,"props":414,"children":415},{},[416],{"type":32,"value":417},"# 创建 Session（绑定模型配置、Workspace）\n",{"type":23,"tag":381,"props":419,"children":421},{"class":383,"line":420},5,[422],{"type":23,"tag":381,"props":423,"children":424},{},[425],{"type":32,"value":426},"POST /sessions/\n",{"type":23,"tag":381,"props":428,"children":430},{"class":383,"line":429},6,[431],{"type":23,"tag":381,"props":432,"children":433},{"emptyLinePlaceholder":18},[434],{"type":32,"value":408},{"type":23,"tag":381,"props":436,"children":438},{"class":383,"line":437},7,[439],{"type":23,"tag":381,"props":440,"children":441},{},[442],{"type":32,"value":443},"# 开始对话（流式响应）\n",{"type":23,"tag":381,"props":445,"children":447},{"class":383,"line":446},8,[448],{"type":23,"tag":381,"props":449,"children":450},{},[451],{"type":32,"value":452},"POST /chat/\n",{"type":23,"tag":381,"props":454,"children":456},{"class":383,"line":455},9,[457],{"type":23,"tag":381,"props":458,"children":459},{},[460],{"type":32,"value":461},"Body: {\"agent_id\": \"...\", \"session_id\": \"...\", \"input\": \"...\"}\n",{"type":23,"tag":28,"props":463,"children":464},{},[465],{"type":32,"value":466},"每个 Session 独立管理上下文，支持分页查询历史消息，再也不用担心上下文爆炸。",{"type":23,"tag":137,"props":468,"children":470},{"id":469},"_5-workspace-抽象本地-docker-云沙箱随意切换-️",[471],{"type":32,"value":472},"5. Workspace 抽象，本地 / Docker / 云沙箱随意切换 ️",{"type":23,"tag":28,"props":474,"children":475},{},[476],{"type":32,"value":477},"这是 2.0 架构上最优雅的抽象之一。",{"type":23,"tag":28,"props":479,"children":480},{},[481],{"type":32,"value":482},"Workspace 是 Agent 的工作空间，2.0 提供了三种实现：",{"type":23,"tag":484,"props":485,"children":486},"table",{},[487,506],{"type":23,"tag":488,"props":489,"children":490},"thead",{},[491],{"type":23,"tag":492,"props":493,"children":494},"tr",{},[495,501],{"type":23,"tag":496,"props":497,"children":498},"th",{},[499],{"type":32,"value":500},"类型",{"type":23,"tag":496,"props":502,"children":503},{},[504],{"type":32,"value":505},"适用场景",{"type":23,"tag":507,"props":508,"children":509},"tbody",{},[510,528,545],{"type":23,"tag":492,"props":511,"children":512},{},[513,523],{"type":23,"tag":514,"props":515,"children":516},"td",{},[517],{"type":23,"tag":191,"props":518,"children":520},{"className":519},[],[521],{"type":32,"value":522},"LocalWorkspaceManager",{"type":23,"tag":514,"props":524,"children":525},{},[526],{"type":32,"value":527},"本地开发调试",{"type":23,"tag":492,"props":529,"children":530},{},[531,540],{"type":23,"tag":514,"props":532,"children":533},{},[534],{"type":23,"tag":191,"props":535,"children":537},{"className":536},[],[538],{"type":32,"value":539},"DockerWorkspaceManager",{"type":23,"tag":514,"props":541,"children":542},{},[543],{"type":32,"value":544},"隔离的沙箱环境",{"type":23,"tag":492,"props":546,"children":547},{},[548,557],{"type":23,"tag":514,"props":549,"children":550},{},[551],{"type":23,"tag":191,"props":552,"children":554},{"className":553},[],[555],{"type":32,"value":556},"E2BWorkspaceManager",{"type":23,"tag":514,"props":558,"children":559},{},[560],{"type":32,"value":561},"云端 Serverless 执行",{"type":23,"tag":28,"props":563,"children":564},{},[565,570],{"type":23,"tag":72,"props":566,"children":567},{},[568],{"type":32,"value":569},"代码完全不用改",{"type":32,"value":571},"，切换 Workspace Manager 即可。从开发到生产，一套代码走天下。",{"type":23,"tag":137,"props":573,"children":575},{"id":574},"_6-middleware-机制灵活扩展不改核心代码",[576],{"type":32,"value":577},"6. Middleware 机制，灵活扩展不改核心代码 🔌",{"type":23,"tag":28,"props":579,"children":580},{},[581,583,588],{"type":32,"value":582},"受到 Web 框架（如 FastAPI、Express）的启发，2.0 引入了",{"type":23,"tag":72,"props":584,"children":585},{},[586],{"type":32,"value":587},"中间件机制",{"type":32,"value":589},"：",{"type":23,"tag":64,"props":591,"children":592},{},[593,604,615],{"type":23,"tag":68,"props":594,"children":595},{},[596,602],{"type":23,"tag":191,"props":597,"children":599},{"className":598},[],[600],{"type":32,"value":601},"CORSMiddleware",{"type":32,"value":603},"：解决跨域问题（就是我踩坑的那个！）",{"type":23,"tag":68,"props":605,"children":606},{},[607,613],{"type":23,"tag":191,"props":608,"children":610},{"className":609},[],[611],{"type":32,"value":612},"AGUIProtocolMiddleware",{"type":32,"value":614},"：将 AgentScope 事件转换为 AGUI 协议",{"type":23,"tag":68,"props":616,"children":617},{},[618,624],{"type":23,"tag":191,"props":619,"children":621},{"className":620},[],[622],{"type":32,"value":623},"ToolOffloadMiddleware",{"type":32,"value":625},"：工具执行卸载",{"type":23,"tag":28,"props":627,"children":628},{},[629,631,636],{"type":32,"value":630},"你可以编写自己的中间件，",{"type":23,"tag":72,"props":632,"children":633},{},[634],{"type":32,"value":635},"不修改框架核心代码",{"type":32,"value":637},"就能扩展功能。这才是成熟的框架设计。",{"type":23,"tag":137,"props":639,"children":641},{"id":640},"_7-agent-service-内置直接部署为可调用服务",[642],{"type":32,"value":643},"7. Agent Service 内置，直接部署为可调用服务 🚀",{"type":23,"tag":28,"props":645,"children":646},{},[647],{"type":32,"value":648},"这可能是最\"生产力\"的特性。",{"type":23,"tag":28,"props":650,"children":651},{},[652],{"type":32,"value":653},"2.0 内置了基于 FastAPI 的 Agent Service，支持：",{"type":23,"tag":64,"props":655,"children":656},{},[657,667,677,687,704],{"type":23,"tag":68,"props":658,"children":659},{},[660,665],{"type":23,"tag":72,"props":661,"children":662},{},[663],{"type":32,"value":664},"多租户",{"type":32,"value":666},"：不同用户独立的数据和会话",{"type":23,"tag":68,"props":668,"children":669},{},[670,675],{"type":23,"tag":72,"props":671,"children":672},{},[673],{"type":32,"value":674},"多会话",{"type":32,"value":676},"：每个 Agent 可以有多个独立会话",{"type":23,"tag":68,"props":678,"children":679},{},[680,685],{"type":23,"tag":72,"props":681,"children":682},{},[683],{"type":32,"value":684},"Redis 存储后端",{"type":32,"value":686},"：持久化 Agent 配置、会话状态、消息历史",{"type":23,"tag":68,"props":688,"children":689},{},[690,695,696,702],{"type":23,"tag":72,"props":691,"children":692},{},[693],{"type":32,"value":694},"内置 API 文档",{"type":32,"value":589},{"type":23,"tag":191,"props":697,"children":699},{"className":698},[],[700],{"type":32,"value":701},"http://localhost:8000/docs",{"type":32,"value":703}," 直接查看和测试",{"type":23,"tag":68,"props":705,"children":706},{},[707,712],{"type":23,"tag":72,"props":708,"children":709},{},[710],{"type":32,"value":711},"AGUI 协议兼容",{"type":32,"value":713},"：支持第三方 Web UI 接入",{"type":23,"tag":371,"props":715,"children":717},{"className":373,"code":716,"language":375,"meta":7,"style":7},"from agentscope.app import create_app\nfrom agentscope.app.storage import RedisStorage\n\napp = create_app(storage=RedisStorage())\nuvicorn.run(app, host=\"0.0.0.0\", port=8000)\n",[718],{"type":23,"tag":191,"props":719,"children":720},{"__ignoreMap":7},[721,729,737,744,752],{"type":23,"tag":381,"props":722,"children":723},{"class":383,"line":384},[724],{"type":23,"tag":381,"props":725,"children":726},{},[727],{"type":32,"value":728},"from agentscope.app import create_app\n",{"type":23,"tag":381,"props":730,"children":731},{"class":383,"line":393},[732],{"type":23,"tag":381,"props":733,"children":734},{},[735],{"type":32,"value":736},"from agentscope.app.storage import RedisStorage\n",{"type":23,"tag":381,"props":738,"children":739},{"class":383,"line":402},[740],{"type":23,"tag":381,"props":741,"children":742},{"emptyLinePlaceholder":18},[743],{"type":32,"value":408},{"type":23,"tag":381,"props":745,"children":746},{"class":383,"line":411},[747],{"type":23,"tag":381,"props":748,"children":749},{},[750],{"type":32,"value":751},"app = create_app(storage=RedisStorage())\n",{"type":23,"tag":381,"props":753,"children":754},{"class":383,"line":420},[755],{"type":23,"tag":381,"props":756,"children":757},{},[758],{"type":32,"value":759},"uvicorn.run(app, host=\"0.0.0.0\", port=8000)\n",{"type":23,"tag":28,"props":761,"children":762},{},[763],{"type":23,"tag":72,"props":764,"children":765},{},[766],{"type":32,"value":767},"几行代码，一个生产级的 Agent 服务就部署好了。",{"type":23,"tag":35,"props":769,"children":770},{},[],{"type":23,"tag":52,"props":772,"children":774},{"id":773},"架构升级从-10-到-20-到底改变了什么",[775],{"type":32,"value":776},"架构升级：从 1.0 到 2.0 到底改变了什么？",{"type":23,"tag":28,"props":778,"children":779},{},[780],{"type":32,"value":781},"用一张对比表说清楚：",{"type":23,"tag":484,"props":783,"children":784},{},[785,806],{"type":23,"tag":488,"props":786,"children":787},{},[788],{"type":23,"tag":492,"props":789,"children":790},{},[791,796,801],{"type":23,"tag":496,"props":792,"children":793},{},[794],{"type":32,"value":795},"维度",{"type":23,"tag":496,"props":797,"children":798},{},[799],{"type":32,"value":800},"AgentScope 1.0",{"type":23,"tag":496,"props":802,"children":803},{},[804],{"type":32,"value":805},"AgentScope 2.0",{"type":23,"tag":507,"props":807,"children":808},{},[809,838,888,909,930,951,972],{"type":23,"tag":492,"props":810,"children":811},{},[812,820,829],{"type":23,"tag":514,"props":813,"children":814},{},[815],{"type":23,"tag":72,"props":816,"children":817},{},[818],{"type":32,"value":819},"部署方式",{"type":23,"tag":514,"props":821,"children":822},{},[823],{"type":23,"tag":191,"props":824,"children":826},{"className":825},[],[827],{"type":32,"value":828},"AgentApp.deploy(\"/process\")",{"type":23,"tag":514,"props":830,"children":831},{},[832],{"type":23,"tag":191,"props":833,"children":835},{"className":834},[],[836],{"type":32,"value":837},"create_app(storage=...)",{"type":23,"tag":492,"props":839,"children":840},{},[841,849,860],{"type":23,"tag":514,"props":842,"children":843},{},[844],{"type":23,"tag":72,"props":845,"children":846},{},[847],{"type":32,"value":848},"API 设计",{"type":23,"tag":514,"props":850,"children":851},{},[852,854],{"type":32,"value":853},"单端点 ",{"type":23,"tag":191,"props":855,"children":857},{"className":856},[],[858],{"type":32,"value":859},"/process",{"type":23,"tag":514,"props":861,"children":862},{},[863,865,871,873,879,880,886],{"type":32,"value":864},"模块化 REST API (",{"type":23,"tag":191,"props":866,"children":868},{"className":867},[],[869],{"type":32,"value":870},"/chat",{"type":32,"value":872},", ",{"type":23,"tag":191,"props":874,"children":876},{"className":875},[],[877],{"type":32,"value":878},"/agent",{"type":32,"value":872},{"type":23,"tag":191,"props":881,"children":883},{"className":882},[],[884],{"type":32,"value":885},"/sessions",{"type":32,"value":887},")",{"type":23,"tag":492,"props":889,"children":890},{},[891,899,904],{"type":23,"tag":514,"props":892,"children":893},{},[894],{"type":23,"tag":72,"props":895,"children":896},{},[897],{"type":32,"value":898},"通信协议",{"type":23,"tag":514,"props":900,"children":901},{},[902],{"type":32,"value":903},"自定义流式",{"type":23,"tag":514,"props":905,"children":906},{},[907],{"type":32,"value":908},"SSE + AGUI 协议",{"type":23,"tag":492,"props":910,"children":911},{},[912,920,925],{"type":23,"tag":514,"props":913,"children":914},{},[915],{"type":23,"tag":72,"props":916,"children":917},{},[918],{"type":32,"value":919},"状态管理",{"type":23,"tag":514,"props":921,"children":922},{},[923],{"type":32,"value":924},"内存为主",{"type":23,"tag":514,"props":926,"children":927},{},[928],{"type":32,"value":929},"Redis 持久化",{"type":23,"tag":492,"props":931,"children":932},{},[933,941,946],{"type":23,"tag":514,"props":934,"children":935},{},[936],{"type":23,"tag":72,"props":937,"children":938},{},[939],{"type":32,"value":940},"权限控制",{"type":23,"tag":514,"props":942,"children":943},{},[944],{"type":32,"value":945},"无/粗粒度",{"type":23,"tag":514,"props":947,"children":948},{},[949],{"type":32,"value":950},"细粒度 + 动态策略",{"type":23,"tag":492,"props":952,"children":953},{},[954,962,967],{"type":23,"tag":514,"props":955,"children":956},{},[957],{"type":23,"tag":72,"props":958,"children":959},{},[960],{"type":32,"value":961},"工作空间",{"type":23,"tag":514,"props":963,"children":964},{},[965],{"type":32,"value":966},"本地文件系统",{"type":23,"tag":514,"props":968,"children":969},{},[970],{"type":32,"value":971},"Workspace 抽象（本地/Docker/云）",{"type":23,"tag":492,"props":973,"children":974},{},[975,983,988],{"type":23,"tag":514,"props":976,"children":977},{},[978],{"type":23,"tag":72,"props":979,"children":980},{},[981],{"type":32,"value":982},"扩展机制",{"type":23,"tag":514,"props":984,"children":985},{},[986],{"type":32,"value":987},"修改源码",{"type":23,"tag":514,"props":989,"children":990},{},[991],{"type":32,"value":992},"Middleware 插件",{"type":23,"tag":28,"props":994,"children":995},{},[996],{"type":23,"tag":72,"props":997,"children":998},{},[999],{"type":32,"value":1000},"一句话总结：2.0 不再是\"能跑的 Demo\"，而是\"能用的产品\"。",{"type":23,"tag":35,"props":1002,"children":1003},{},[],{"type":23,"tag":52,"props":1005,"children":1007},{"id":1006},"多语言生态python-已就位typescript-同步上线java-即将发布",[1008],{"type":32,"value":1009},"多语言生态：Python 已就位，TypeScript 同步上线，Java 即将发布",{"type":23,"tag":64,"props":1011,"children":1012},{},[1013,1057,1080],{"type":23,"tag":68,"props":1014,"children":1015},{},[1016,1021,1022,1028,1030],{"type":23,"tag":72,"props":1017,"children":1018},{},[1019],{"type":32,"value":1020},"Python",{"type":32,"value":589},{"type":23,"tag":191,"props":1023,"children":1025},{"className":1024},[],[1026],{"type":32,"value":1027},"v2.0.0",{"type":32,"value":1029},"（2026-05-25 发布）",{"type":23,"tag":64,"props":1031,"children":1032},{},[1033,1046],{"type":23,"tag":68,"props":1034,"children":1035},{},[1036,1038],{"type":32,"value":1037},"GitHub: ",{"type":23,"tag":1039,"props":1040,"children":1044},"a",{"href":1041,"rel":1042},"https://github.com/agentscope-ai/agentscope",[1043],"nofollow",[1045],{"type":32,"value":1041},{"type":23,"tag":68,"props":1047,"children":1048},{},[1049,1051],{"type":32,"value":1050},"文档: ",{"type":23,"tag":1039,"props":1052,"children":1055},{"href":1053,"rel":1054},"https://docs.agentscope.io/v2",[1043],[1056],{"type":32,"value":1053},{"type":23,"tag":68,"props":1058,"children":1059},{},[1060,1065,1067],{"type":23,"tag":72,"props":1061,"children":1062},{},[1063],{"type":32,"value":1064},"TypeScript",{"type":32,"value":1066},"：同步上线",{"type":23,"tag":64,"props":1068,"children":1069},{},[1070],{"type":23,"tag":68,"props":1071,"children":1072},{},[1073,1074],{"type":32,"value":1037},{"type":23,"tag":1039,"props":1075,"children":1078},{"href":1076,"rel":1077},"https://github.com/agentscope-ai/agentscope-typescript",[1043],[1079],{"type":32,"value":1076},{"type":23,"tag":68,"props":1081,"children":1082},{},[1083,1088],{"type":23,"tag":72,"props":1084,"children":1085},{},[1086],{"type":32,"value":1087},"Java",{"type":32,"value":1089},"：即将发布",{"type":23,"tag":35,"props":1091,"children":1092},{},[],{"type":23,"tag":52,"props":1094,"children":1096},{"id":1095},"实战体验5-分钟搭建你的第一个-agent-服务",[1097],{"type":32,"value":1098},"实战体验：5 分钟搭建你的第一个 Agent 服务",{"type":23,"tag":28,"props":1100,"children":1101},{},[1102],{"type":32,"value":1103},"说了这么多，实际用起来怎么样？看看我刚才的部署过程：",{"type":23,"tag":371,"props":1105,"children":1107},{"className":373,"code":1106,"language":375,"meta":7,"style":7},"# run_service.py\nfrom agentscope.app import create_app\nfrom agentscope.app.storage import RedisStorage\nfrom fastapi.middleware.cors import CORSMiddleware\nimport uvicorn\n\n# 创建 Redis 存储\nstorage = RedisStorage(host=\"localhost\", port=6379, db=0)\n\n# 创建应用\napp = create_app(storage=storage)\n\n# 添加 CORS（开发环境）\napp.add_middleware(CORSMiddleware, allow_origins=[\"*\"])\n\n# 启动服务\nuvicorn.run(app, host=\"0.0.0.0\", port=8000)\n",[1108],{"type":23,"tag":191,"props":1109,"children":1110},{"__ignoreMap":7},[1111,1119,1126,1133,1141,1149,1156,1164,1172,1179,1188,1197,1205,1214,1223,1231,1240],{"type":23,"tag":381,"props":1112,"children":1113},{"class":383,"line":384},[1114],{"type":23,"tag":381,"props":1115,"children":1116},{},[1117],{"type":32,"value":1118},"# run_service.py\n",{"type":23,"tag":381,"props":1120,"children":1121},{"class":383,"line":393},[1122],{"type":23,"tag":381,"props":1123,"children":1124},{},[1125],{"type":32,"value":728},{"type":23,"tag":381,"props":1127,"children":1128},{"class":383,"line":402},[1129],{"type":23,"tag":381,"props":1130,"children":1131},{},[1132],{"type":32,"value":736},{"type":23,"tag":381,"props":1134,"children":1135},{"class":383,"line":411},[1136],{"type":23,"tag":381,"props":1137,"children":1138},{},[1139],{"type":32,"value":1140},"from fastapi.middleware.cors import CORSMiddleware\n",{"type":23,"tag":381,"props":1142,"children":1143},{"class":383,"line":420},[1144],{"type":23,"tag":381,"props":1145,"children":1146},{},[1147],{"type":32,"value":1148},"import uvicorn\n",{"type":23,"tag":381,"props":1150,"children":1151},{"class":383,"line":429},[1152],{"type":23,"tag":381,"props":1153,"children":1154},{"emptyLinePlaceholder":18},[1155],{"type":32,"value":408},{"type":23,"tag":381,"props":1157,"children":1158},{"class":383,"line":437},[1159],{"type":23,"tag":381,"props":1160,"children":1161},{},[1162],{"type":32,"value":1163},"# 创建 Redis 存储\n",{"type":23,"tag":381,"props":1165,"children":1166},{"class":383,"line":446},[1167],{"type":23,"tag":381,"props":1168,"children":1169},{},[1170],{"type":32,"value":1171},"storage = RedisStorage(host=\"localhost\", port=6379, db=0)\n",{"type":23,"tag":381,"props":1173,"children":1174},{"class":383,"line":455},[1175],{"type":23,"tag":381,"props":1176,"children":1177},{"emptyLinePlaceholder":18},[1178],{"type":32,"value":408},{"type":23,"tag":381,"props":1180,"children":1182},{"class":383,"line":1181},10,[1183],{"type":23,"tag":381,"props":1184,"children":1185},{},[1186],{"type":32,"value":1187},"# 创建应用\n",{"type":23,"tag":381,"props":1189,"children":1191},{"class":383,"line":1190},11,[1192],{"type":23,"tag":381,"props":1193,"children":1194},{},[1195],{"type":32,"value":1196},"app = create_app(storage=storage)\n",{"type":23,"tag":381,"props":1198,"children":1200},{"class":383,"line":1199},12,[1201],{"type":23,"tag":381,"props":1202,"children":1203},{"emptyLinePlaceholder":18},[1204],{"type":32,"value":408},{"type":23,"tag":381,"props":1206,"children":1208},{"class":383,"line":1207},13,[1209],{"type":23,"tag":381,"props":1210,"children":1211},{},[1212],{"type":32,"value":1213},"# 添加 CORS（开发环境）\n",{"type":23,"tag":381,"props":1215,"children":1217},{"class":383,"line":1216},14,[1218],{"type":23,"tag":381,"props":1219,"children":1220},{},[1221],{"type":32,"value":1222},"app.add_middleware(CORSMiddleware, allow_origins=[\"*\"])\n",{"type":23,"tag":381,"props":1224,"children":1226},{"class":383,"line":1225},15,[1227],{"type":23,"tag":381,"props":1228,"children":1229},{"emptyLinePlaceholder":18},[1230],{"type":32,"value":408},{"type":23,"tag":381,"props":1232,"children":1234},{"class":383,"line":1233},16,[1235],{"type":23,"tag":381,"props":1236,"children":1237},{},[1238],{"type":32,"value":1239},"# 启动服务\n",{"type":23,"tag":381,"props":1241,"children":1243},{"class":383,"line":1242},17,[1244],{"type":23,"tag":381,"props":1245,"children":1246},{},[1247],{"type":32,"value":759},{"type":23,"tag":28,"props":1249,"children":1250},{},[1251],{"type":32,"value":1252},"运行：",{"type":23,"tag":371,"props":1254,"children":1258},{"className":1255,"code":1256,"language":1257,"meta":7,"style":7},"language-bash shiki shiki-themes dracula","python run_service.py\n","bash",[1259],{"type":23,"tag":191,"props":1260,"children":1261},{"__ignoreMap":7},[1262],{"type":23,"tag":381,"props":1263,"children":1264},{"class":383,"line":384},[1265,1270],{"type":23,"tag":381,"props":1266,"children":1268},{"style":1267},"--shiki-default:#50FA7B",[1269],{"type":32,"value":375},{"type":23,"tag":381,"props":1271,"children":1273},{"style":1272},"--shiki-default:#F1FA8C",[1274],{"type":32,"value":1275}," run_service.py\n",{"type":23,"tag":28,"props":1277,"children":1278},{},[1279],{"type":32,"value":1280},"服务启动后，你可以：",{"type":23,"tag":64,"props":1282,"children":1283},{},[1284,1296,1301],{"type":23,"tag":68,"props":1285,"children":1286},{},[1287,1289,1294],{"type":32,"value":1288},"访问 ",{"type":23,"tag":191,"props":1290,"children":1292},{"className":1291},[],[1293],{"type":32,"value":701},{"type":32,"value":1295}," 查看 API 文档",{"type":23,"tag":68,"props":1297,"children":1298},{},[1299],{"type":32,"value":1300},"通过 REST API 创建 Agent、Session，开始对话",{"type":23,"tag":68,"props":1302,"children":1303},{},[1304],{"type":32,"value":1305},"接入支持 AGUI 协议的 Web UI",{"type":23,"tag":28,"props":1307,"children":1308},{},[1309],{"type":23,"tag":72,"props":1310,"children":1311},{},[1312],{"type":32,"value":1313},"总共不到 15 行代码，一个生产级的 Agent 服务就跑起来了。",{"type":23,"tag":35,"props":1315,"children":1316},{},[],{"type":23,"tag":52,"props":1318,"children":1320},{"id":1319},"踩坑提醒web-ui-兼容性问题",[1321],{"type":32,"value":1322},"踩坑提醒：Web UI 兼容性问题",{"type":23,"tag":28,"props":1324,"children":1325},{},[1326],{"type":32,"value":1327},"如果你也遇到了和我一样的问题——Web UI 连不上 2.0 服务——这里给个快速排查指南：",{"type":23,"tag":28,"props":1329,"children":1330},{},[1331,1336,1338],{"type":23,"tag":72,"props":1332,"children":1333},{},[1334],{"type":32,"value":1335},"症状",{"type":32,"value":1337},"：Web UI 配置了 base URL，但报 ",{"type":23,"tag":191,"props":1339,"children":1341},{"className":1340},[],[1342],{"type":32,"value":1343},"404 Not Found",{"type":23,"tag":28,"props":1345,"children":1346},{},[1347,1352,1353,1359,1361,1366],{"type":23,"tag":72,"props":1348,"children":1349},{},[1350],{"type":32,"value":1351},"原因",{"type":32,"value":589},{"type":23,"tag":191,"props":1354,"children":1356},{"className":1355},[],[1357],{"type":32,"value":1358},"agentscope-runtime",{"type":32,"value":1360}," 的 Web UI 还没有适配2.0，使用的依然是 1.0 的 ",{"type":23,"tag":191,"props":1362,"children":1364},{"className":1363},[],[1365],{"type":32,"value":859},{"type":32,"value":1367}," 端点，而 2.0 的 API 架构已经改变。",{"type":23,"tag":28,"props":1369,"children":1370},{},[1371,1376],{"type":23,"tag":72,"props":1372,"children":1373},{},[1374],{"type":32,"value":1375},"临时方案",{"type":32,"value":1377},"：等待 Web UI 更新支持 2.0 API，或者自行编写适配层。",{"type":23,"tag":28,"props":1379,"children":1380},{},[1381,1386],{"type":23,"tag":72,"props":1382,"children":1383},{},[1384],{"type":32,"value":1385},"我已经给 agentscope-runtime 提了 Issue",{"type":32,"value":1387},"，相信社区会很快跟进。",{"type":23,"tag":28,"props":1389,"children":1390},{},[1391],{"type":23,"tag":1392,"props":1393,"children":1396},"img",{"alt":1394,"src":1395},"image.png","https://jjbiji-pic.oss-cn-beijing.aliyuncs.com/20260526181322031.png",[],{"type":23,"tag":35,"props":1398,"children":1399},{},[],{"type":23,"tag":52,"props":1401,"children":1403},{"id":1402},"写在最后",[1404],{"type":32,"value":1402},{"type":23,"tag":28,"props":1406,"children":1407},{},[1408,1410,1415],{"type":32,"value":1409},"AgentScope 2.0 的这次升级，不是在堆功能，而是在",{"type":23,"tag":72,"props":1411,"children":1412},{},[1413],{"type":32,"value":1414},"解决 AI Agent 落地过程中真正会遇到的坑",{"type":32,"value":1416},"。",{"type":23,"tag":64,"props":1418,"children":1419},{},[1420,1425,1430,1435,1440,1445,1450],{"type":23,"tag":68,"props":1421,"children":1422},{},[1423],{"type":32,"value":1424},"自动重试 + 备用模型 → 服务更稳定",{"type":23,"tag":68,"props":1426,"children":1427},{},[1428],{"type":32,"value":1429},"实时可见 + 可干预 → 用户更信任",{"type":23,"tag":68,"props":1431,"children":1432},{},[1433],{"type":32,"value":1434},"细粒度权限 → 操作更安全",{"type":23,"tag":68,"props":1436,"children":1437},{},[1438],{"type":32,"value":1439},"结构化上下文 → 长任务更可靠",{"type":23,"tag":68,"props":1441,"children":1442},{},[1443],{"type":32,"value":1444},"Workspace 抽象 → 部署更灵活",{"type":23,"tag":68,"props":1446,"children":1447},{},[1448],{"type":32,"value":1449},"Middleware 机制 → 扩展更容易",{"type":23,"tag":68,"props":1451,"children":1452},{},[1453],{"type":32,"value":1454},"内置 Service → 上线更快速",{"type":23,"tag":28,"props":1456,"children":1457},{},[1458],{"type":23,"tag":72,"props":1459,"children":1460},{},[1461],{"type":32,"value":1462},"这不是一个\"更好的实验框架\"，而是一个\"更成熟的生产平台\"。",{"type":23,"tag":28,"props":1464,"children":1465},{},[1466],{"type":32,"value":1467},"如果你正在寻找一个能让 AI Agent 在真实场景中稳定跑起来的框架，AgentScope 2.0 值得一试。",{"type":23,"tag":35,"props":1469,"children":1470},{},[],{"type":23,"tag":28,"props":1472,"children":1473},{},[1474],{"type":23,"tag":72,"props":1475,"children":1476},{},[1477],{"type":32,"value":1478},"资源链接：",{"type":23,"tag":64,"props":1480,"children":1481},{},[1482,1492,1502],{"type":23,"tag":68,"props":1483,"children":1484},{},[1485,1487],{"type":32,"value":1486},"GitHub (Python): ",{"type":23,"tag":1039,"props":1488,"children":1490},{"href":1041,"rel":1489},[1043],[1491],{"type":32,"value":1041},{"type":23,"tag":68,"props":1493,"children":1494},{},[1495,1497],{"type":32,"value":1496},"GitHub (TypeScript): ",{"type":23,"tag":1039,"props":1498,"children":1500},{"href":1076,"rel":1499},[1043],[1501],{"type":32,"value":1076},{"type":23,"tag":68,"props":1503,"children":1504},{},[1505,1506],{"type":32,"value":1050},{"type":23,"tag":1039,"props":1507,"children":1509},{"href":1053,"rel":1508},[1043],[1510],{"type":32,"value":1053},{"type":23,"tag":1512,"props":1513,"children":1514},"style",{},[1515],{"type":32,"value":1516},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":7,"searchDepth":393,"depth":393,"links":1518},[1519,1520,1529,1530,1531,1532,1533],{"id":54,"depth":393,"text":57},{"id":132,"depth":393,"text":135,"children":1521},[1522,1523,1524,1525,1526,1527,1528],{"id":139,"depth":402,"text":142},{"id":174,"depth":402,"text":177},{"id":313,"depth":402,"text":316},{"id":354,"depth":402,"text":357},{"id":469,"depth":402,"text":472},{"id":574,"depth":402,"text":577},{"id":640,"depth":402,"text":643},{"id":773,"depth":393,"text":776},{"id":1006,"depth":393,"text":1009},{"id":1095,"depth":393,"text":1098},{"id":1319,"depth":393,"text":1322},{"id":1402,"depth":393,"text":1402},"markdown","content:blogs:agentscope-2-production.md","content","blogs/agentscope-2-production.md","blogs/agentscope-2-production","md",{"loc":4},1779982357444]