CLI 参考

iamai 和 python -m iamai 使用同一套入口。

运行 Runtime

iamai --config config.toml
iamai --config config.toml run

如果没有指定子命令，默认执行 run。

配置检查

iamai --config config.toml config-check

该命令会：

  • 加载 TOML；

  • 校验内置配置模型；

  • 加载插件；

  • 校验插件配置；

  • 构建适配器；

  • 打印风险告警。

配置 Schema

iamai --config config.toml config-schema
iamai --config config.toml config-schema echo

如果插件声明了 Pydantic config_model，这里会输出 JSON Schema。

内置管理命令

启用 management 插件并允许 introspection 后，可在消息入口使用这些诊断命令：

  • /plugins：列出已加载插件。

  • /plugin <name>：查看单个插件元数据。

  • /plugin-config <name>：查看插件配置 schema。

  • /handlers：列出已注册 handler。

  • /adapters：列出已加载适配器。

  • /health：查看运行时健康摘要。

  • /metrics：查看运行时计数器。

  • /sessions：查看活跃 session。

  • /trace / /trace last：查看插件 trace 摘要或最近一条 trace。