playbook 可以接受和发出上下文信息 使用明确定义的参数。 参数用于存储有关对话的信息，例如 用户选择、操作结果等。 您可以将这些参数的值传递到 使用 playbook 和 Dialogflow CX 流程。
参数声明
使用 Vertex AI Agents 时， 您可以在代理编辑器页面上定义参数。
使用 Dialogflow CX 时， 参数是针对每个 playbook 使用 Parameters 创建 playbook 后即可。
参数包括名称、说明 以及以下任一类型：
- 字符串
- 数字
- 布尔值
- 工具专用参数类型
您还可以指定某个参数是否为列表。
输入参数
输入参数允许 playbook 使用传递的值 其他策略方案 例如，playbook 可能会收到 作为参数，并使用它来亲自感谢用户， 或者可能会接收订单标识符作为参数， 并使用它来检索订单详情，方法是使用 工具。
输入参数是按 playbook 定义的，而 playbook 则没有 公开范围 其他 Dialogflow CX 参数类型 默认情况。 当 Dialogflow CX 流程过渡到 playbook 时， page 和 session 参数会传播到 playbook 如果目标 playbook 具有同名的输入参数。 如需在过渡期间将信息从流传递到 playbook， 定义与会话同名的 playbook 输入参数 或页面参数。
创建示例来控制输入参数值应如何影响操作。 例如，如果输入参数应该影响代理的 创建示例来定义参数值，然后使用 相同的值。请参阅 传递参数。
输出参数
输出参数允许 playbook 发出信息 以供其他流程或策略方案使用。 例如，playbook 可能会从 并通过输出参数发出 或者策略方案可以使用 工具 预订航班并通过输出参数发出确认号。
创建示例来控制策略方案应如何做出决定 每个输出参数的值。 例如，如果一个输出参数表示确认 数字应从工具使用的输出中得出， 创建样本，其中工具的输出 use 与 playbook 输出参数的值一致。
传递参数
playbook 与数据流不同，不支持注入参数值 特定的语法。 策略方案以操作说明为依据， 少样本提示示例 以确定应如何使用参数值以及应如何 决定的参数值。
不妨考虑使用专为活动门票销售业务设计的客服人员，并参考以下手册：
- 一个名为
Ticket ordering的 playbook，使用工具下单 名为Ticket sales API。- 此 playbook 接受类型为
number且名称为名称的输入参数event_id. Ticket sales API工具需要请求包含event_id。
- 此 playbook 接受类型为
- 一个名为
Event selection的 playbook，它可帮助用户选择事件，然后 使用参数event_id将商品路由到Ticket ordering以购买 工单。
在此示例中，为了确保 event_id 从
从 Event selection 到 Ticket ordering，从 Ticket ordering 到
Ticket sales API，若干
示例
所需的资源。
Ticket ordering playbook 应包含符合以下要求的多个示例：
- 为输入参数
event_id指定不同的实际值 。 - 添加工具使用操作，其请求正文包含相同
输入参数中指定的实际
event_id值。
Event selection playbook 应包含符合以下要求的多个示例：
- 加入用户话语，其中用户选择的事件具有真实感
event_id，每个示例中都不同。 - 添加
Ticket ordering的 playbook 调用，以便设置event_id参数分配给由用户确定的同一真实event_id选择。
除了添加示例外，还可以尝试在
说明，
goal，或
工具详细信息
解释应如何使用参数。例如：
playbook Ticket ordering 包含以下说明：
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
通过上述示例和说明，Event selection
playbook 会根据用户的选择正确决定 event_id，以及
将名为 event_id 的输入参数传递给
Ticket ordering playbook.然后，Ticket ordering 会传递相同的 event_id
。Ticket sales APIplaybook 依赖于示例
不同的参数值，以帮助他们推断应如何使用参数。