你有一个在笔记本里跑通的 LangGraph 图,现在需要让别人来调用它:同事、一个 Telegram 机器人,或者一个会发问题、等答案的 CRM。这意味着要有一个 Web API、一台一直开着的服务器、锁定版本的依赖、一个模型密钥,以及一个不是谁都能拿来烧你模型预算的网址。

打开网易新闻 查看精彩图片

这次演示把一个小型 LangGraph 智能体从笔记本上的文件夹,搬到 uagents8 上的一个公网 HTTPS 地址,再用一个令牌把那扇门锁上。在 2026 年 10 月 28 日的这次运行里,智能体创建后 78 秒就上线了,其中构建大约占了 38 秒。

要部署的东西并不复杂:一张图,两个节点,一条分支。

START 判断问题是不是纯算术,是就走 calculate,然后到 END;

其余问题走 respond,然后到 END;

calculate 是一个纯 Python 的工具节点;

respond 是留给模型的位置,在你接入模型之前,它返回一个带标记的占位回答,所以整套东西不需要密钥、不需要联网就能跑。

这张图挂在 FastAPI 后面,真正重要的路由只有一个:POST /ask。

算术解析只接受数字上的加、减、乘、除和括号,别的都不认,所以用户输入永远不会进到 eval 里。表达式写错了会得到一句礼貌的回答,而不是让服务崩掉。

平台对代码有三点要求

第一,监听 PORT,绑定 0.0.0.0。平台会设置 PORT;绑到 127.0.0.1 的服务器本地跑得好好的,外面却永远连不上。

第二,先开始监听,再干慢活。健康检查只问端口接不接受连接,不请求任何路由,所以只有 /ask 的 API 也没问题。它给端口大约 150 秒的打开时间。大模型或索引要放在服务起来之后再加载,或者等第一次请求时懒加载。

第三,锁定每一个依赖。构建跑的是 Python 3.12,没有编译器,所以要挑带 wheel 的版本。在干净的虚拟环境里执行 pip install fastapi uvicorn langgraph,再 pip freeze > requirements.txt。示例里锁的是 fastapi==0.143.3、uvicorn==0.54.0、langgraph==1.2.16。main.py 和 requirements.txt 放在顶层,平台会运行 python main.py。不需要写构建文件:平台从你的代码推断构建方式,如果项目顶层已经有自己的构建文件,它就照那个文件来。

部署流程

把文件夹推到 GitHub、GitLab 或 Bitbucket 仓库,或者把 main.py 和 requirements.txt 打成 zip。在控制台点 + Deploy Agent:来源选 Git 服务商和仓库,之后每次推送到该分支都会重新部署;或者选 Code Archive 上传 zip。配置里保持 Continuous Service,选一个资源规格,规格就是内存上限:T 是 256 MB,S 是 512 MB,L 是 1 GB。这次运行里智能体大约用了 80 MB,T 就够。确认后点 Deploy agent。

状态页会从 Building agent 走到 Starting your agent,再到 Running。这次以 zip 上传、没有模型密钥,用了 78 秒。之后智能体页面会显示它的公网地址。

用 curl 发一个 POST 到 /ask,问“what is 2+3*4?”,返回的是 2+3*4 = 14,mode 为 tool。问别的东西就会拿到占位回答,mode 为 stub,这说明通往模型的那条分支已经接好、正在等着。

接入模型与令牌

把服务商的客户端库(锁版本)写进 requirements.txt,用模型调用替换 respond 的函数体。然后在智能体的 Settings → Environment Variables 里加上密钥,打开 Sensitive,重新部署。变量改动会在下一次部署时生效。密钥永远不进代码,也不进仓库。

接下来是多数教程会跳过的一步。你的智能体现在有了公网地址,而它背后是按 token 计费的模型。谁找到这个地址,谁就能花你的预算。

打开智能体的 Settings 标签,找到 Access tokens,选 Generate agent token。给它起一个你认得出的名字(crm、telegram-bot),选有效期:7 天、30 天、90 天,或者不过期。复制它,它以 uagt_live_ 开头,只显示一次。带 Authorization: Bearer 头的调用能通过;没有有效令牌的调用会在碰到你的代码或模型之前就收到 401 Unauthorized。一个智能体有了第一个令牌之后,所有调用方都需要令牌,所以要在生成之前先给现有调用方发好。一个调用方一个令牌,泄露一个就能单独吊销,不影响其他人。

部署失败时

迟早会失败:本地装了却没锁版本的包、在一个文件里改了名另一个文件没改的变量、绑到 localhost 的服务器。失败智能体的页面会用平实的语言解释错误。点 Fix with AI,它会读错误和你的代码,改一份副本,构建前先检查补丁,再把修好的副本作为新版本部署。如果这份副本也失败,它会再试一次。你的仓库不会被改动,一键就能恢复上一个版本。

费用

规格 T 在所有套餐里都能用,从 Builder 的每月 19 欧元起(价格为税前)。月付套餐都带 14 天全功能免费试用。需要绑卡以防滥用,不选套餐继续用就不会扣费。发布期间,LAUNCH30 在 Builder 或 Growth 的月付账单上给前三个月打 7 折,有效期到 11 月 30 日;配合试用,折扣从试用结束后的第一次付款开始算。从笔记本上的代码,到一个带令牌保护的公网地址,就在欧洲。