LlamaAgents

这个 Agent 能做什么，适合哪些场景？

LlamaAgents 是一个面向 Python 的开源框架，用于构建和交付以文档为中心的智能应用。其核心 Agent Workflows 将流程表示为一组异步步骤：步骤消费事件、执行处理，再发出后续事件，从而支持分支、循环、并行执行和状态持久化。工作流可以直接嵌入脚本、Notebook、FastAPI 或 Starlette 应用，也可以通过 llama-agents-server 暴露为带流式输出、持久化和人工介入能力的 REST API。llama-agents-client 提供配套异步客户端，llamactl 则负责初始化、开发和部署应用。部署范围涵盖 LlamaParse、AWS Bedrock AgentCore 和自有基础设施，应用形式可以是无界面工作流服务、MCP 服务器或带 UI 的全栈应用。

开发者通过继承 Workflow 并用 @step 标记异步 Python 函数来定义执行步骤；步骤接收 StartEvent 等事件，并返回或发出 StopEvent 等后续事件。流程可串接 OCR、大模型调用、结构化抽取、分类、自定义校验、图像分析和人工审核，但这些具体处理需要由应用代码或外部服务提供。运行时能够进行分支、循环、并行化、状态持久化以及失败后的恢复，并最终通过 StopEvent.result 等字段产出结果。工作流可以用 await workflow.run(...) 在进程内执行，也可以注册到 WorkflowServer，通过 REST API、流式响应及 llama-agents-client 供其他服务调用。llamactl 提供从模板初始化、本地热重载到创建部署的命令，并可将应用交付为工作流服务、MCP 服务器或全栈应用。

1. 需要把 OCR、结构化抽取、分类、自定义校验和人工复核串成可靠流程的文档处理团队。
2. 先在 Notebook 中验证少量合同处理方案、之后希望沿用同一套工作流代码上线的 Python 开发者。
3. 每月处理大量发票，并需要把执行放在客户防火墙或受限环境内的企业团队。
4. 希望把现有异步工作流挂载进 FastAPI 或 Starlette，并以 REST API 提供给其他服务的后端团队。
5. 需要频繁迭代抽取逻辑，同时希望通过持久化和失败恢复减少长流程重跑的工程团队。
6. 希望使用 CLI 将工作流部署到 LlamaParse、AWS Bedrock AgentCore 或自有基础设施的应用团队。

如何安装或部署这个 Agent？

最小的库模式安装命令如下：

pip install llama-index-workflows

源码只明确要求 Python，但没有给出最低 Python 版本、虚拟环境步骤或完整依赖矩阵。基础的进程内工作流未注明需要凭据；接入 LlamaParse、AWS Bedrock AgentCore 或其他外部服务时所需的账户、凭据和配置未在所给材料中说明。若要使用部署 CLI，可安装 llamactl：

uv tool install llamactl

如何使用这个 Agent？

定义一个最小工作流：

from workflows import Workflow, step
from workflows.events import StartEvent, StopEvent

class HelloWorkflow(Workflow):
    @step
    async def greet(self, ev: StartEvent) -> StopEvent:
        return StopEvent(result=f"Hello, {ev.name}")

文档给出的进程内执行接口是 await workflow.run(...)，但没有提供包含事件参数和 Python 入口函数的完整可运行示例。要将工作流注册到服务器，可使用：

from llama_agents.server import WorkflowServer

server = WorkflowServer()
server.add_workflow("greet", HelloWorkflow())

所给材料没有列出启动服务器的具体命令、端口配置或客户端请求示例。使用 llamactl 时，支持的基本流程为：

llamactl init
llamactl serve
llamactl deployments create

其中 llamactl serve 用于本地开发，材料说明其支持热重载；部署目标的认证和配置步骤未提供。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. [email protected] 2026-10-23
   发布说明摘录

   Patch Changes - 9bf7f4a: Release the chart whenever the operator, appserver, or control plane image it ships is bumped.

   在 GitHub 查看 ↗
2. [email protected] 2026-10-23
   发布说明摘录

   Patch Changes - 64fbd6c: Builds link the UI output at /opt/app/.llama-ui so nginx serves the UI for pushed deployments. - 3ac8112: Keep UI directory redirects on the public host when serving built files behind a proxy.

   在 GitHub 查看 ↗
3. [email protected] 2026-10-23
   发布说明摘录

   Patch Changes - 64fbd6c: Builds link the UI output at /opt/app/.llama-ui so nginx serves the UI for pushed deployments.

   在 GitHub 查看 ↗

常见问题