Jido

Jido 是一个专为 Elixir 设计的自主智能体（Autonomous agent）框架，旨在构建复杂的工作流和多智能体系统。

通过定义智能体、连接动作（Actions）、信号（Signals）和指令（Directives），你可以利用其内置的监督机制和容错能力来运行智能体。

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

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

概述

Jido 帮助你像构建普通 Elixir 和 OTP 软件一样构建智能体系统。

• 智能体持有状态并实现 cmd/2
• 动作执行工作并转换状态
• 信号将事件路由到系统中
• 指令描述由运行时执行的效果

当你需要软件能够检查上下文、在多个步骤中做出选择、与其他智能体协作，并长期稳定运行时，请使用 Jido。

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

其核心在于，Jido 智能体是具有单个命令函数的不可变数据结构：

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)

状态变化是纯粹的数据转换；副作用被描述为指令，并由 OTP 运行时执行。这样你就能获得确定性的智能体逻辑、无需进程即可测试的能力，以及在生产环境中运行这些智能体的清晰路径。

Jido 生态系统

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

包名	描述
req_llm	用于 LLM API 的 HTTP 客户端
jido_action	可组合、经过验证的动作，带有 AI 工具集成
jido_signal	基于 CloudEvents 的消息信封及用于路由和发布/订阅消息的实用工具
jido	核心智能体框架，提供状态管理、指令和运行时
jido_ai	智能体的 AI/LLM 集成

有关你可以使用 Jido 生态系统构建的内容的演示和示例，请查看 https://jido.run。

为什么选择 Jido？

OTP 原生功能非常出色。你可以用原始的 GenServer 构建智能体系统，但当构建多个协作智能体时，你需要重复造轮子：

原始 OTP	Jido 的规范化实现
每个 GenServer 都有临时的消息格式	将信号作为标准信封
业务逻辑与回调函数混杂	将动作作为可重用的命令模式
隐式副作用分散在代码中	将指令作为类型化的效果描述
每个服务器自定义子进程追踪	内置父/子层级结构
进程退出即完成	基于状态的完成语义

Jido 并不是“更好的 GenServer”，而是构建在 GenServer 之上的规范化智能体模式。

核心特性

不可变智能体架构

• 受 Elm/Redux 启发的纯函数式智能体设计
• cmd/2 作为核心操作：输入动作，输出更新后的智能体和指令
• 使用 NimbleOptions 或 Zoi 进行模式验证的状态

基于指令的效果系统

• 动作转换状态；指令描述外部效果
• 内置指令：Emit（发射）、Spawn（生成）、SpawnAgent（生成智能体）、StopChild（停止子进程）、Schedule（调度）、Stop（停止）
• 基于协议的可扩展性，支持自定义指令

OTP 运行时集成

• 基于 GenServer 的 AgentServer，适用于生产环境部署
• 具有生命周期管理的父子智能体层级结构
• 具有可配置策略的信号路由系统