Jido：Elixir自治代理框架的终极指南

JidoElixir自治代理框架的终极指南【免费下载链接】jido Autonomous agent framework for Elixir. Built for distributed, autonomous behavior and dynamic workflows.项目地址: https://gitcode.com/GitHub_Trending/ji/jidoJido 是一个为 Elixir 打造的自治代理框架专为工作流和多代理系统设计。它让你能够定义代理、连接动作、信号和指令并内置监督和容错机制使软件能够检查上下文、选择多个步骤、与其他代理协作并长时间可靠运行。为什么选择 JidoOTP 原语非常出色你可以使用原始的 GenServer 构建代理系统。但是当构建多个协作代理时你会重新发明许多轮子原始 OTPJido 形式化每个 GenServer 的特定消息形状作为标准信封的信号业务逻辑混合在回调中作为可重用命令模式的动作代码中分散的隐式效果作为类型化效果描述的指令每个服务器的自定义子跟踪内置的父/子层次结构进程退出 完成基于状态的完成语义Jido 不是“更好的 GenServer”——它是构建在 GenServer 之上的形式化代理模式。核心特性不可变代理架构受 Elm/Redux 启发的功能代理状态模型cmd/2作为核心操作带 NimbleOptions 或 Zoi 的模式验证状态基于指令的效果动作转换状态并可能执行所需工作指令描述运行时拥有的外部效果内置多种指令及可扩展的自定义指令协议OTP 运行时集成基于 GenServer 的 AgentServer 用于生产部署带生命周期管理的父子代理层次结构可配置策略的信号路由可组合插件扩展代理的可重用功能模块每个插件的状态隔离与自动模式合并初始化和信号处理的生命周期钩子执行策略简单工作流的直接执行状态驱动工作流的 FSM有限状态机策略自定义执行模式的可扩展策略协议多代理编排带可配置策略的多代理工作流复杂工作流的基于计划的编排具有命名拓扑的持久代理组快速安装 Jido使用 Igniter推荐最快的入门方式是使用 Ignitermix igniter.install jido这会自动将 Jido 添加到依赖项创建MyApp.Jido实例模块use Jido, otp_app: :my_app在config/config.exs中创建配置将MyApp.Jido添加到监督树生成示例代理开始使用mix igniter.install jido --example手动安装将jido添加到mix.exs中的依赖项列表def deps do [ {:jido, ~ 2.0} ] end然后定义 Jido 实例模块并将其添加到监督树# In lib/my_app/jido.ex defmodule MyApp.Jido do use Jido, otp_app: :my_app end# In config/config.exs config :my_app, MyApp.Jido, max_tasks: 1000, agent_pools: []# In your application.ex children [ MyApp.Jido ] Supervisor.start_link(children, strategy: :one_for_one)快速上手 Jido1. 定义代理defmodule MyApp.CounterAgent do use Jido.Agent, name: counter, description: A simple counter agent, schema: [ count: [type: :integer, default: 0] ], signal_routes: [ {increment, MyApp.Actions.Increment} ] end2. 定义动作defmodule MyApp.Actions.Increment do use Jido.Action, name: increment, description: Increments the counter by a given amount, schema: [ amount: [type: :integer, default: 1] ] def run(params, context) do current context.state[:count] || 0 {:ok, %{count: current params.amount}} end end3. 执行命令# 创建代理 agent MyApp.CounterAgent.new() # 执行动作 - 返回更新的代理 指令 {agent, directives} MyApp.CounterAgent.cmd(agent, {MyApp.Actions.Increment, %{amount: 5}}) # 检查状态 agent.state.count # 54. 使用 AgentServer 运行# 启动代理服务器 {:ok, pid} MyApp.Jido.start_agent(MyApp.CounterAgent, id: counter-1) # 向运行中的代理发送信号同步 # 信号类型必须在 signal_routes 中声明 {:ok, agent} Jido.AgentServer.call(pid, Jido.Signal.new!(increment, %{amount: 10}, source: /user)) # 通过 ID 查找代理 pid MyApp.Jido.whereis(counter-1) # 列出所有运行中的代理 agents MyApp.Jido.list_agents()Jido 核心概念cmd/2契约Jido 中的基本操作{agent, directives} MyAgent.cmd(agent, action)关键不变量返回的agent始终是完整的 - 不需要“应用指令”步骤directives仅描述运行时拥有的外部效果 - 它们从不修改代理状态代理决策逻辑保持显式和可测试确定性动作产生确定性cmd/2结果动作 vs 指令 vs 状态操作动作指令状态操作转换状态可能执行副作用描述运行时拥有的效果描述内部状态变化由cmd/2执行更新agent.state代理发出的裸结构体由策略层应用可以调用 API、读取文件、查询数据库运行时AgentServer解释它们从不离开策略状态操作Jido.Agent.StateOp状态操作是在cmd/2期间由策略层处理的内部状态转换。与指令不同它们永远不会到达运行时。状态操作目的SetState将属性深度合并到状态中ReplaceState完全替换状态DeleteKeys删除顶级键SetPath在嵌套路径设置值DeletePath删除嵌套路径的值指令类型指令目的Emit通过配置的适配器调度信号Error从 cmd/2 发出错误信号Spawn生成通用 BEAM 子进程SpawnAgent生成跟踪的子 Jido 代理默认restart: :transientStopChild优雅地停止并移除跟踪的子代理StartSensor启动或替换标记的传感器运行时StopSensor停止标记的传感器运行时Schedule安排延迟消息Stop停止代理进程Jido 生态系统Jido 是 Jido 生态系统的核心包。生态系统围绕核心 Jido Agent 行为构建并提供多个可选包来扩展核心行为。包描述req_llmLLM API 的 HTTP 客户端jido_action具有 AI 工具集成的可组合、已验证动作jido_signal基于 CloudEvents 的消息信封和用于路由和发布/订阅消息的支持工具jido具有状态管理、指令和运行时的核心代理框架jido_ai代理的 AI/LLM 集成深入学习 Jido从这里开始快速入门 - 在 5 分钟内构建你的第一个代理核心循环 - 理解思维模型指南构建代理 - 代理定义和状态管理信号与路由 - 基于信号的通信代理指令 - 运行时的效果描述运行时和 AgentServer - 基于进程的代理执行选择运行时模式 - 何时使用SpawnAgent、InstanceManager、Pod和partitionPods - 具有命名拓扑、延迟激活、嵌套 pod 和实时添加/删除突变的持久代理组多租户 - 具有分区和 Pod 优先持久工作区的共享实例租户持久性和存储 - 休眠、解冻和 InstanceManager 生命周期调度 - 声明式和动态 cron 调度插件 - 可组合功能包策略 - 执行策略直接、FSM高级FSM 策略深入探讨 - 状态机工作流工作池 - 用于吞吐量的预热代理池测试代理 - 测试模式和最佳实践API 参考hexdocs.pm/jido常见问题解答一般问题Q: Jido 是什么它与其他代理框架有何不同A: Jido 是一个为 Elixir 打造的自治代理框架专为工作流和多代理系统设计。主要区别OTP 原生架构构建在 GenServer 之上内置监督和容错不可变代理受 Elm/Redux 启发的功能状态模型AI 可选核心包提供代理架构不需要 AI/LLM显式效果边界动作可以拥有即时工作指令描述运行时拥有的效果Q: AI 是 Jido 必需的吗A:不核心包 (jido) 提供代理架构和运行时而无需 AI。AI/LLM 集成可通过配套包可选添加jido_ai代理的 AI/LLM 集成req_llmLLM API 的 HTTP 客户端当软件需要检查上下文、选择步骤、协调代理并可靠运行时使用 Jido - AI 是可选的。功能Q: 有哪些可用的指令A: 内置指令Emit向系统发出信号Error从cmd/2发出错误信号Spawn生成子进程SpawnAgent生成子代理AdoptChild将孤立或未附加的子项附加到当前父项StopChild停止子进程/代理StartSensor启动或替换所有者监控的标记传感器运行时StopSensor停止标记的传感器运行时Schedule安排未来动作RunInstruction在运行时执行指令并将结果路由回cmd/2Stop停止代理Cron / CronCancel注册和取消基于 cron 的计划外部包也可以定义自定义指令结构体。有关详细信息请参见 代理指令。Q: 插件如何工作A: 可组合插件通过以下方式扩展代理可重用功能模块每个插件的状态隔离与自动模式合并跨代理的轻松功能共享有关详细信息请参见 插件指南。Q: 有哪些可用的执行策略A:直接策略立即执行FSM 策略状态机工作流请参见 策略指南 和 FSM 策略深入探讨。帮助资源文档hexdocs.pm/jido网站jido.run生态系统jido.run/ecosystemDiscordjido.run/discordGitHubgithub.com/agentjido/jidoJido Workbenchgithub.com/agentjido/jido_workbench【免费下载链接】jido Autonomous agent framework for Elixir. Built for distributed, autonomous behavior and dynamic workflows.项目地址: https://gitcode.com/GitHub_Trending/ji/jido创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考