好，咱们今天要讲的内容，是跟 Agentforce 和咱们自定义组件的人工智能描述相关的。想象一下，以后用户只要用一句大白话描述自己想要什么功能，Agentforce 就能智能地分析出来，然后推荐咱们的组件。这个靠的就是咱们在组件里放一段特殊的 AI 描述。
具体怎么做呢？你要在组件的 js‑meta.html 文件的顶层，放一个 `
` 标签。注意啊，每个组件文件里只能放一次这个标签。在这个 `` 标签里面，要包含一个总的描述标签，然后里面可以有多个属性标签，每个属性都有自己的 `name` 和 `aiDiagnostics` 属性。
但有一点要记住，那些属性的定义，还是必须老老实实地在 `targetConfig` 里再定义一遍，AI 描述只是额外给它加层说明，不会替代它。
那什么样的描述才是好描述呢？一个好的 AI 描述必须清晰地回答四个问题：第一，受众是谁，也就是谁会用到这个组件；第二，功能，它到底能做什么；第三，好处，用户为什么要用它；第四，上下文，就是在什么场景下、什么时候用它最合适。
所以你在写的时候，要用最终用户能听懂的语言来写，千万别用技术黑话。比如，要有详细的例子，说明它可配置的选项有哪些，也要诚实地写它有什么限制，或者跟别的组件比好在哪里。特别要记得，还要写清楚这个组件，不能，做什么，这样 Agentforce 就不会在错误的情况下推荐它了。
反过来，糟糕的描述是什么样的呢？要么很模糊，比如写“用于一般用途”，要么满嘴开发术语，像“CRUD 操作”这种，用户听了完全不知道是什么。这就是我们要避免的。
总结一下，把 AI 描述写好，其实就是帮 Agentforce 更准确地把咱们的组件推给真正需要的人。这样做既提升了用户体验，也让你的组件更容易被发现和重用。