使用变量

Microsoft Copilot Studio 支持您使用变量存储客户输入的重要信息，以供之后使用。 例如，您可以在名为 varName 的变量中保存客户的名称。 本变量可以插入到对话节点中，以为客户打造更个性化的体验，例如将其插入到消息节点中，以允许代理在对话继续时按名称处理客户。

变量可用于将客户动态传递到不同的对话路径。 它们还可以作为输入参数输入到 Power Automate 流或 Bot Framework 技能中。 例如，客户居住的城市可以存储在变量中。 执行 Power Automate 流时，可将该变量作为输入参数传递，以确保天气服务进行正确的预测。

许多变量类型与代理中定义的现成可用的自定义实体相关联。 提供了完整的实体和变量类型列表以供您参考。

创建变量

当您将问题节点添加到主题时，将自动创建变量，并且可以在将用户回复另存为部分下进行编辑。 默认情况下，当插入问题节点时，将使用多选选项创建它。 但是，若要使用任何预生成实体或自定义实体，请在标识下选择它。

重命名变量

自动创建变量时，将提供非描述性的默认名称，例如 Var1、Var2 等。 如果需要，您可以通过选择变量，然后在变量属性窗格中输入新名称来重命名变量。 这将使以后需要它时更容易识别。

在主题之间传递变量

在 Microsoft Copilot Studio 代理中，一个常见的操作是从一个主题重定向到另一个主题，例如在问候某人后将其转到 Store Hours 主题。 重定向到另一主题时，您可以将值传递给目标主题中的变量。 您还可以将值传回原始主题中的变量。 当您已经获得主题所需的信息时，在主题之间传递变量特别有用。 用户将很高兴不必重复回答问题。 例如，如果您已经在问候语主题中捕获了用户的姓名，并且您知道该用户的姓名在您要重定向到的商店营业时间主题中使用，则在重定向到 Store Hours 主题时，您可以轻松地将该用户的姓名传递到该主题。

接收其他主题中的值

当您在主题中定义变量时（例如，通过插入问题节点），用户对该问题的回答将填充到与该问题关联的变量中。 既然您已经获得了该值，就没有理由再问这个问题了。 在这些情况下，您可以将该变量定义为接收其他主题中的值。

这意味着当另一个主题重定向到此主题时，它可以将一个值传递到此变量中，并跳过问题。 当用户与代理交谈时将获得无缝体验。

配置重定向节点时，您需要定义要在目标主题中填充什么变量。 指定要在目标主题中设置的变量后，您将指定将使用当前主题中的哪个值。 例如，在下图中，我们要重定向到一个名为位置的主题。 位置主题中的 UserCity 变量将设置为来自重定向主题的名为 Location 的文本变量。

有关从其他主题接收值的更多信息和分步说明，请参阅接收其他主题中的值。

将值返回到原始主题

当一个主题以其他方式提出问题或从操作中获取变量时，该变量可以返回到重定向到它的原始主题。

在这种情况下，该变量也成为原始主题的一部分，可以像任何其他变量一样使用。 这有助于您构建主题，以便代理获取的信息可在各主题间使用，从而减少对全局变量的需求。 我们将在下一单元中讨论全局变量。

有关详细信息和分步说明，请参阅将值返回到原始主题。

要了解有关使用变量的更多信息，请参阅使用变量。