Jido Elixir 智能体框架

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

Jido 是一个用于构建工作流和多主体系统的 Elixir 自主智能体框架。它将智能体定义为带状态、实现 cmd/2 的不可变结构；Action 执行工作并转换状态，Signal 将事件路由进系统，Directive 描述由运行时处理的外部效果。生产运行使用基于 GenServer 的 AgentServer，并提供监督、父子智能体生命周期、信号路由、实例分区和多租户边界。框架还提供 Direct 与 FSM 执行策略、可组合插件、计划式编排和 Pod 形式的持久智能体组。AI 不是核心运行条件，模型集成由 jido_ai 等生态包按需提供。

开发者用 use Jido.Agent 定义名称、描述、schema 和 signal_routes，再用 use Jido.Action 定义带参数 schema 的 run/2。调用 MyAgent.cmd(agent, {ActionModule, params}) 会执行 Action，返回更新后的 agent 与 directives；StateOp 由策略层处理状态更新，而 Emit、SpawnAgent、Schedule、Stop 等 Directive 由 AgentServer 运行时解释。运行中的 AgentServer 可通过 Jido.AgentServer.call(pid, Jido.Signal.new!("increment", %{amount: 10}, source: "/user")) 接收 Signal；实例模块可用 start_agent、whereis 和 list_agents 管理进程。

1. Elixir 后端团队需要把多个长期运行、可监督的业务进程组织为协作工作流时。
2. 需要将 CloudEvents 风格消息路由到有明确状态和命令边界的服务时。
3. 构建需要父子进程生命周期管理、延迟调度或运行时发射事件的 BEAM 应用时。
4. 希望以 FSM 策略实现状态驱动流程，而非在 GenServer 回调中混合业务逻辑时。
5. 需要在共享实例中通过 logical partitions 或 Pod 管理多租户工作空间时。

如何安装或部署这个 Agent？

运行：

mix igniter.install jido

这会添加依赖、创建 MyApp.Jido、写入配置并加入监督树。也可在 mix.exs 添加 {:jido, "~> 2.0"}，创建：

defmodule MyApp.Jido do
use Jido, otp_app: :my_app

end

在 config/config.exs 配置：

config :my_app, MyApp.Jido, max_tasks: 1000, agent_pools: []

并将 MyApp.Jido 放入 application.ex 的 children。文档要求 Elixir 1.17+ 与 Erlang/OTP 26+；未说明凭据要求。

如何使用这个 Agent？

先定义 Agent 和 Action，例如为 Agent 配置 signal_routes: [{"increment", MyApp.Actions.Increment}]，并在 Action 的 run/2 中返回 {:ok, %{count: current + params.amount}}。创建并执行：

agent = MyApp.CounterAgent.new()

{agent, directives} = MyApp.CounterAgent.cmd(agent, {MyApp.Actions.Increment, %{amount: 5}})

要以进程方式运行：

{:ok, pid} = MyApp.Jido.start_agent(MyApp.CounterAgent, id: "counter-1")
{:ok, agent} = Jido.AgentServer.call(pid, Jido.Signal.new!("increment", %{amount: 10}, source: "/user"))

Signal 类型必须已在 signal_routes 中声明。

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

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

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

FollowAgents 如何评估这个 Agent？

常见问题