创建操作时，请遵循以下最佳实践：

• 使用连接进行身份验证。请勿在操作配置中包含身份验证凭证。而应使用连接 ，因为这些连接专用于确保您敏感详情的安全。
• 请注意访问权限。请记住，连接可能比您的专员或终端用户具有更高的访问权限。配置您的操作、 程序和专员培训，避免将敏感数据共享给错误的受众。
• 尽可能确保数据的私密性。在捕获部分操作响应作为输出时，请注意仅捕获您需要的特定数据点。捕获与手头任务不直接相关的数据并非良好的隐私保护实践，此外，可能会对自动协助产生混淆。
• 为操作、输入和输出撰写合适的名称和描述。名称和描述有助于自动协助确定操作（包括其输入和输出）何时与客户请求相关。此外，如果您对现有操作进行更改，请确保名称和描述仍然准确。

  名称和描述必须清楚描述操作的含义和结果。例如：

  • 操作名称：将图书添加到购物车
  • 操作描述：添加一本书到客户的购物车。

  在自动协助程序中引用操作时，请使用相似的语言来引用特定操作。

  • 例如：“在客户确认要购买的电子书后，将其添加到购物车。”
• 规划缺失的输入。如果输入有时可用，请确保您的描述说明了应如何处理该情况。例如，并非每个请求者都有电邮地址。因此，对于名为 requester_email_address 的输入，您可能会说：“发起工单的终端用户的电邮地址。如果这不可用，请填写“不可用”。
• 明确区分操作流程和操作流程的名称和描述 如果同时使用操作和操作流程，则明确区分二者使用的名称和描述非常重要。虽然操作和操作流程在管理中心的不同部分进行管理，自动协助仍会看到这两者，并认为它们是等效的。

  例如，如果您有一个名为“订单退款”的操作和一个名为“订单退款”的操作流程，则描述需要足够详细，以区分它们。如果两者的描述都含糊不清，自动协助可能会建议错误的描述，或两者兼顾。

管理员可在管理中心创建新的外部操作。外部操作需要输入、API 调用和输出。

• 输入 是操作运行所使用的信息。您定义的每个输入都会创建一个输入占位符，可以插入到操作的 URL、正文、查询参数或标头中。

  自动协助在执行操作时会用数据替换这些占位符。在操作流程中，占位符可用于操作流程步骤的各种属性。

• API 调用 是指信息在发送到 API 时应具有的确切结构。
• 输出 决定了 Zendesk 如何解释 API 返回的数据。您定义的输出会告诉操作在执行操作时将 API 响应的哪些部分发送回自动协助。

创建外部操作

在创建操作时，您应该对其进行测试，以确保其如预期运行。如有必要，请使用不同的输入值运行多个会产生不同响应的测试，以测试所有可能的输出。

测试操作的步骤

如果您在测试期间遇到问题，可参考以下故障排除建议：

• 如果您使用外部操作与外部系统交互，该产品的文档是详细排除故障的最佳来源。
• 有关测试期间可能遇到的 HTTP 错误代码的概览，请参阅 HTTP 响应状态代码。
• 确保所有输入和输出的数据类型（整数、小数、字符串或布尔值）都适合您的用例。
• 您可在 整合日志中查看更多关于操作执行的详情。