主题
注意
LlamaAgents 的云端部署目前处于 beta 预览阶段,已广泛开放以供反馈。你可以在本地试用,或部署到 LlamaCloud 并通过应用内的反馈按钮把意见发给我们。
LlamaAgents 允许你直接从 LlamaCloud 界面 一键部署文档工作流智能体。挑一个预置的起始模板、配置密钥、然后部署——完全不需要命令行。
用起始模板开始
在 LlamaCloud 控制台里,进入你项目中的 Agents。如果还没有任何部署,你会看到一个「Jumpstart your Agent」区域,展示可用的起始模板。
每个起始模板都是一个完整可用的文档工作流应用,演示如何把 LlamaCloud 的文档原语——Parse、Extract 与 Classify——组合成一条多步流水线。
可用的起始模板
| 模板 | 说明 | 关键特性 |
|---|---|---|
| SEC Insights | 对金融类 PDF 分类并抽取结构化洞察 | 面向 SEC 文件的 Parse → Classify → Extract 流水线 |
| 发票 + 合同匹配 | 解析发票并与合同匹配,找出差异 | 多文档对账工作流 |
部署一个起始模板
- 点击某个起始模板卡片,打开部署对话框
- 为你的部署输入一个名称(仅限字母、数字与短横线)
- 如果该模板需要 API key(例如
OPENAI_API_KEY),在 Required secrets 区域填入 - 点击 Deploy
LlamaCloud 会克隆模板仓库、构建你的应用并部署。通常耗时 1–3 分钟。部署完成后,你的智能体会带着状态出现在部署列表中。
查看你的智能体
当部署状态显示为 Running,点击 Visit 即可打开智能体的界面。多数起始模板都带有 Web 界面,你可以在其中:
- 上传待处理的文档
- 查看抽取出的数据与分类结果
- 复核并修正结果(针对抽取复核类工作流)
许多模板还附带示例数据文件。点击部署卡片上的 Example Data 即可下载测试文档。
定制你的部署
起始模板完全可以定制。要修改工作流逻辑、界面或配置:
Fork 后修改
- 点击部署卡片上的 Customize,或从下拉菜单选择 Edit
- 按链接在 GitHub 上 fork 该仓库
- 在你的 fork 中做出改动
- 把部署的 Repository URL 改成指向你的 fork
- 点击 Update,用你的改动重新部署
可以定制哪些部分
每个 LlamaAgents 部署都是一个标准 Python 项目,包含:
- 工作流(
src/):使用 Parse、Extract、Classify 及其他 LlamaCloud 服务的 LlamaIndex Workflow 定义 - 界面(
ui/):用@llamaindex/uihooks 实现的 React 前端 - 配置(
pyproject.toml):工作流注册、环境设置与构建配置
项目结构的细节见配置参考。
管理部署
部署之后,你可以在 LlamaCloud 界面里管理你的智能体:
更新到最新版本
如果你已向仓库推送了改动:
- 点击部署卡片上的 ⋮ 菜单
- 选择 Update Version
- 确认后即从你配置的分支拉取并部署最新提交
Rollback
如果某次部署更新引发了问题:
- 点击 ⋮ 菜单并选择 Rollback
- 在历史列表中挑一个早先的发布
- 点击 Rollback 恢复到那个版本
编辑设置
要更改源仓库或分支:
- 从部署菜单选择 Edit
- 更新 Repository URL 或 Branch
- 点击 Update
注意
私有仓库需要安装 LlamaAgents GitHub App。在配置私有仓库时,系统会提示你安装它。
Delete
要移除一个部署:
- 从部署菜单选择 Delete
- 确认删除
删除部署是不可逆的。所有关联的资源与数据都会被移除。
后续步骤
准备深入代码了?在托管你的工作流中了解如何编写并配置工作流。