37 · 开发者工具（Developer Tooling）

IntelliJ IDEA 插件

Embabel Agent IntelliJ IDEA 插件为"用 Embabel 框架开发 Agent"提供 IDE 级支持。 它直接与 IntelliJ 平台集成，带来更干净、无警告的开发体验。

它做什么

当你用 Embabel 的核心注解 —— @Action、@Condition 或 @Cost —— 标注方法时， IntelliJ 无从得知框架会在运行时通过反射调用这些方法。 没有插件时，IDE 会把这些方法标记为未使用，于是你的 Agent 代码里到处是误报的 "never used" 警告。

该插件向 IntelliJ 平台注册了一个 ImplicitUsageProvider，告诉 IDE：

任何被 @Action、@Condition 或 @Cost 标注的方法，都被 Embabel Agent 框架隐式使用 —— 不要警告。

这意味着你可以干净地编写 Agent，既不必抑制正当的 IDE 检查，也不必在代码里到处撒 @SuppressWarnings。

没有插件时：

@Agent(description = "Summarizes news articles")
class NewsAgent {

    @Action // ⚠ IntelliJ: "Method 'summarize' is never used"
    fun summarize(article: RawArticle): ArticleSummary {
        // ...
    }
}

有插件时：

@Agent(description = "Summarizes news articles")
class NewsAgent {

    @Action // ✅ 无警告 —— 插件把这些方法标记为隐式使用
    fun summarize(article: RawArticle): ArticleSummary {
        // ...
    }
}

安装（Installation）

该插件已发布到 JetBrains Marketplace（插件 ID：31142）。

通过 IDE 安装（推荐）

• 打开 IntelliJ IDEA；
• 进入 Settings → Plugins → Marketplace 标签页；
• 搜索 Embabel Agent；
• 点击 Install，然后按提示重启 IDE。

通过 Marketplace 网站安装

• 访问 https://plugins.jetbrains.com/plugin/31142-embabel-agent；
• 点击 Get，按浏览器提示打开 IntelliJ IDEA 并安装。

兼容性（Compatibility）

要求	取值
最低 IntelliJ IDEA 版本	2023.3（build 233）
最高 IntelliJ IDEA 版本	无上限 —— 兼容所有未来版本
JVM	21+
插件 ID	com.embabel.agent.intellij-plugin

该插件面向 IntelliJ IDEA（社区版与旗舰版都支持）。 自 IDEA 2025.3 起，社区版与旗舰版已合并为单一统一发行版。

源码与贡献（Source & Contributing）

插件源码维护在独立仓库：https://github.com/embabel/embabel-agent-intellij

欢迎贡献。如果你使用了其它也应被视为"隐式使用"的 Embabel 注解， 请到该仓库开 issue 或提 pull request。