使用 Copilot 创建和编辑 Power Fx 公式

Copilot 是 Power Apps Studio 中的一个人工智能功能,可以帮助您快速创建和修改 Power Fx 公式。 您可以使用公式栏中的 Copilot 来用自然语言解释 Power Fx 公式,或者从自然语言或代码注释中生成 Power Fx 公式。

先决条件

必须为您的环境和租户启用 Copilot。 有关更多信息,请参阅在 Power Apps 中启用或禁用 Copilot(预览版)

备注

默认情况下,启用新的公式栏。 如果 Copilot 功能菜单不可见,请检查 Power Apps Studio 中的以下应用程序设置:

  1. 在命令栏上,选择设置>更新
  2. 已停用选项卡中,关闭传统公式栏开关。

解释公式

使用公式栏中的 Copilot 以简单的语言理解公式的作用。

  1. 选择一个控件及其相应的属性。

  2. 在公式栏上,选择 Copilot 功能菜单>解释此公式,或选择一个公式的子集,然后选择 Copilot 功能菜单>解释此选择,仅解释该部分。

    显示“解释此公式”项目的 Copilot 功能菜单的屏幕截图。

    当 Copilot 提供公式的解释时,您可以复制并将其作为代码注释插入,或与正在使用同一应用程序的其他制作者共享。 在解释选择时,如果对解释很重要,Copilot 也可能提供额外的上下文。

    Copilot 解释公式的截图。

解释公式的已知限制

  • 公式说明的最大长度为 5,000 个字符。 如果公式超出此限制,使用部分解释来确保公式运行。
  • Copilot 仅识别 Power Apps 中的默认属性。
  • Copilot 不识别用户定义的函数。

备注

AI 生成的内容可能不准确,应检查其准确性。

从代码注释生成公式

Copilot 可以从公式栏中的代码注释生成 Power Fx 公式。 您可以接受建议或者自己输入公式。 公式代码注释也可以作为公式的文档,就像常规代码注释一样。

  1. 打开画布应用程序进行编辑,在公式栏中使用 ///* 键入代码注释。

    在 Copilot 公式栏中键入的注释的屏幕截图。

    等待几秒钟,让 Copilot 生成公式建议,或按 Enter 键立即生成。

  2. 按键盘上的 Tab 键接受并使用建议的公式。 您也可以输入建议。

    带有建议公式的注释的屏幕截图。

建议会一直保留,直到您选择其他位置或键入与建议不匹配的字符。

您可以将用于在公式栏中生成 Power Fx 公式的注释保存为文档,类似于传统的代码注释。

备注

  • 如果 Copilot 没有提供建议,则无法根据您的注释生成公式。 请尝试重新措辞注释。
  • 我们建议用引号将您想要包含在公式中的元素括起来,例如 "Button1.text"

从代码注释生成公式的已知限制

  • Copilot 只处理单一的控件和属性,它不会对其他控件或属性进行更改来达到预期的结果。
  • Copilot 不会考虑现有公式文本。
  • Copilot 仅识别 Power Apps 中的默认属性。
  • Copilot 不识别用户定义的函数。
  • 代码注释仅适用于一般 Power Fx 函数,不适用于 Power Apps 特定函数,如 Navigate()
  • 高级面板不会触发建议。
  • 该属性的现有公式不包括在建议中。

创建配方(预览版)

[此部分为预发布文档,可能会更改。]

通过公式栏中的 Copilot 按钮,您现在可以从离散请求的自然语言中生成公式。

先决条件

在您可以使用 Copilot 从画布应用程序中的离散请求创建公式之前,您需要在 Power Apps 的应用程序设置中打开适用于公式的 Copilot

  1. 在 Power Apps Studio 中打开您的画布应用程序进行编辑。 在命令栏上,选择设置>更新
  2. 预览选项卡上,找到并打开适用于公式的 Copilot 设置。

使用 Copilot 从离散请求创建公式

  1. 选择一个控件及其相应的属性。

  2. 在公式栏上,选择 Copilot 功能菜单>创建公式

    显示创建公式项的 Copilot 功能菜单的屏幕截图。

    当公式栏展开时,Copilot 菜单会以内联方式打开,如果公式栏折叠,则会在公式栏下方打开。

  3. 在 Copilot 文本框中,输入您的请求,例如显示今天是星期几

    “创建公式”功能的屏幕截图,显示了一个示例输入。

  4. Copilot 将尝试创建一个公式。 选择接受将公式插入到与 Copilot 界面相同的位置,或者更新并重新提交您的请求。

    显示推荐公司的“创建公式”功能的屏幕截图。

备注

从离散请求创建公式的限制与从代码注释生成公式相同。

负责任 AI

了解您在使用人工智能时的选择。 详情请参见关于在 Power Apps 中负责任地使用 AI 的常见问题解答 请查阅 Power Fx Copilot 常见问题解答,了解有关此功能的具体问题。

语言支持

下表列出了公式栏助手功能可用的语言,这些语言基于您的 Power Platform 环境和浏览器中的设置。

Name 语言代码 支持的功能
英语 en-US 说明公式、注释生成的公式、创建公式
中文(简体)- 中国 zh-Hans 解释公式,注释生成的公式
捷克语 - 捷克共和国 cs-CZ 解释公式,注释生成的公式
丹麦语 - 丹麦 da-DK 解释公式,注释生成的公式
荷兰语 - 荷兰 nl-NL 解释公式,注释生成的公式
芬兰语 - 芬兰 fi-FI 解释公式,注释生成的公式
法语 - 法国 fr-FR 解释公式,注释生成的公式
德语 - 德国 de-DE 解释公式,注释生成的公式
希腊语 - 希腊 el-GR 解释公式,注释生成的公式
意大利语 - 意大利 it-IT 解释公式,注释生成的公式
日语 - 日本 ja-JP 解释公式,注释生成的公式
朝鲜语 - 韩国 ko-KR 解释公式,注释生成的公式
挪威博克马尔语 - 挪威 nb-NO 解释公式,注释生成的公式
波兰语 - 波兰 pl-PL 解释公式,注释生成的公式
葡萄牙语 - 巴西 pt-BR 解释公式,注释生成的公式
俄语 - 俄罗斯 ru-RU 解释公式,注释生成的公式
西班牙语(传统风格) - 西班牙 es-ES 解释公式,注释生成的公式
瑞典语 - 瑞典 sv-SE 解释公式,注释生成的公式
泰语 - 泰国 th-TH 解释公式,注释生成的公式
土耳其语 - 土耳其 tr-TR 解释公式,注释生成的公式

Copilot 根据注释生成的公式(视频)