jido

环境要求

• 已安装 Elixir 与 Erlang/OTP 环境（需 mix 构建工具）
• 可访问 Hex.pm 拉取依赖
• 项目使用 Mix 构建（mix.exs 管理依赖）

安装与启动步骤

1. 1准备 Elixir 项目

   Jido 是 Elixir 库，需先有可编译的 Mix 工程。README 未给出创建工程的命令，可用现成项目或自行初始化。

2. 2添加 jido 依赖

   在项目 mix.exs 的 deps 列表中加入 jido，版本约束为 ~> 2.0（Hex.pm 上的正式包）。

   def deps do
     [
       {:jido, "~> 2.0"}
     ]
   end

   复制

3. 3安装依赖

   执行 Mix 标准依赖拉取，从 Hex.pm 下载并编译 jido 及其依赖。

   mix deps.get

   复制

4. 4定义 Jido 实例

   README 要求定义一个 Jido 实例模块，并把它加入应用的监督树，用于承载 AgentServer 与信号路由。具体代码块在 README 中被截断，完整写法见官网。

5. 5定义智能体模块

   使用 use Jido.Agent 声明名称、描述与 schema。agent 是不可变数据结构，状态字段通过 schema 定义默认值。

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

   复制

6. 6调用 cmd/2 与查看

   用 MyAgent.cmd(agent, action) 处理动作，返回新的 agent 与 directives；再用实例的 list_agents() 列出运行中的智能体。

   {agent, directives} = MyAgent.cmd(agent, action)
   agents = MyApp.Jido.list_agents()

   复制

7. 7运行测试验证

   在项目根目录执行测试套件，确认依赖、编译与运行时均正常。

   mix test

   复制

关键配置

如何确认成功

在项目根目录执行 mix test 并全部通过，说明依赖安装与编译运行正常；运行时可用 MyApp.Jido.list_agents() 看到已启动的智能体。

常见问题

注意事项

• README 的 Quick Start 与监督树代码块被截断，完整可运行示例请参考 jido.run 与 hexdocs.pm/jido 上的 API 文档。
• AI 能力不在核心包内，如需模型调用要额外引入 jido_ai 等配套包。
• 多租户场景可结合实例级监督与逻辑分区使用，生产环境建议使用 AgentServer 而非直接跑裸 Agent。