Jido

Jido 是一个用于 Elixir 的自主 Agent 框架，专为工作流和多 Agent 系统而构建。

定义 Agent，将它们连接到 Action、Signal 和 Directive，并利用内置的监督（Supervision）和容错机制运行它们。

“Jido”（自動）一词源于日语，意为“自动”或“自动化”，其中“自”（ji）意为“自身”，“動”（dō）意为“移动”。

在 jido.run 了解更多关于 Jido 的信息。

概述

Jido 帮助你以标准的 Elixir 和 OTP 软件形式构建 Agent 系统。

• Agent：持有状态并实现 cmd/2
• Action：执行工作并转换状态
• Signal：将事件路由到系统中
• Directive：描述由运行时执行的效果

纯粹性边界在于 Agent 的决策逻辑：Jido 确保 Agent 的决策和状态转换是明确的，Action 可以是纯函数或包含副作用的，而 Directive 则用于希望由运行时托管的副作用。

当你的软件需要检查上下文、在多个步骤中进行选择、与其他 Agent 协调并长期保持可靠运行时，请使用 Jido。

AI 是可选的。核心包提供了 Agent 架构和运行时；当你需要模型集成时，可以使用 jido_ai 等配套包。

核心上，Jido Agent 是具有单一命令函数的不可变数据结构：

defmodule MyAgent do
  use Jido.Agent,
    name: "my_agent",
    description: "My custom agent",
    schema: [
      count: [type: :integer, default: 0]
    ]
end

{agent, directives} = MyAgent.cmd(agent, action)

状态变更是明确的数据转换。如果 Action 需要立即返回结果以继续推理或更新状态，它可以自行执行该工作。如果工作流已经确定了出站效果并希望由运行时或集成层负责交付，则返回一个 Directive。

Jido 生态系统

Jido 是 Jido 生态系统的核心包。该生态系统围绕核心的 Jido Agent 行为构建，并提供多个可选包来扩展核心功能。

包名	描述
req_llm	用于 LLM API 的 HTTP 客户端
jido_action	可组合、经过验证且具备 AI 工具集成的 Action
jido_signal	基于 CloudEvents 的消息信封及用于路由和 Pub/Sub 消息传递的支持工具
jido	包含状态管理、Directive 和运行时的核心 Agent 框架
jido_ai	用于 Agent 的 AI/LLM 集成

有关可以使用 Jido 生态系统构建的内容的演示和示例，请访问 https://jido.run。有关包映射和支持级别，请访问 https://jido.run/ecosystem。

为什么选择 Jido？

OTP 原语非常优秀。你可以使用原生的 GenServer 构建 Agent 系统。但当构建多个协作的 Agent 时，你将不得不重复造轮子：

原生 OTP	Jido 的形式化处理
每个 GenServer 的 Ad-hoc 消息格式	以标准信封形式的 Signal
业务逻辑混入回调中	作为可复用命令模式的 Action
代码中分散的隐式效果	作为类型化效果描述的 Directive
每个服务器自定义子进程追踪	内置的父/子层级结构
进程退出 = 完成	基于状态的完成语义

Jido 并不是“更好的 GenServer”，它是建立在 GenServer 之上的形式化 Agent 模式。

核心特性

不可变 Agent 架构

• 受 Elm/Redux 启发的功能性 Agent 状态模型