跳到内容

OpenAI:生成文本

使用 OpenAI: generate text 在旅程中请求 OpenAI 模型生成一小段文本,然后在后续的推送、电子邮件或短信中重复使用。此节点使用其自己的 OpenAI API 密钥进行身份验证,不使用在“设置”中其他地方配置的任何账户级集成。

典型用途:

  • 个性化消息行: 从旅行者的标签中起草一句单行引子,然后使用动态内容将其放入下一条推送或电子邮件中。
  • 发送前总结: 将一些标签,如上次订单或浏览类别,转换成模板可以显示的简短自然语言行。
  • 变换措辞: 每次运行时要求稍有不同的措辞,这样旅行者每次通过时不会看到完全相同的文本。

配置节点

Anchor link to
  1. 从左侧面板的 Integrations 部分将 OpenAI: generate text 拖到画布上。
  2. 双击该节点并输入 Step Name。
  3. 在 OpenAI API key 中,输入您的 OpenAI API 密钥。它会像 webhook 秘密标头一样被遮盖存储。
OpenAI 生成文本抽屉,已填写步骤名称且 OpenAI API 密钥被遮盖
  1. 在 Model 中,选择要使用的 OpenAI 模型。默认为 gpt-5-mini。

    • gpt-5-nano 和 gpt-5-mini: 两者都能在该节点的 10 秒超时内很好地回答。
    • gpt-5: 在长提示下可能会接近超时。每个 token 的成本比小型号更高。

    每次调用都会向您自己的 OpenAI 密钥计费,适用于到达此步骤的每位旅行者。

模型字段设置为 gpt-5-mini,并附有每个模型的计时说明
  1. 在 Prompt 中,写下您希望模型生成的内容。它接受与任何 Webhook 正文相同的宏,例如 {{device:hwid}}。
提示字段,其中包含使用标签宏的产品推荐提示
  1. 点击 Save。

推理设置为最小,响应上限约为 300 个 token(大约一个短段落),以使请求保持在Webhook 超时范围内。请要求简短的内容。更长或更详细的提示不会获得更多的回答空间。

旅行者会继续前往您在画布上连接的下一个步骤。

步骤运行后的属性

Anchor link to
属性其包含的内容
llm_text生成的文本
llm_input_tokens请求输入的 token 数量
llm_output_tokens请求输出的 token 数量

如何在后续步骤中使用 llm_text

Anchor link to

失败和意外响应

Anchor link to

失败的请求会将旅行者从旅程中移除。请参阅错误和失败的请求。

返回的响应不符合您的预期,旅行者仍会留在旅程中:

  • 文本在 300-token 上限处被截断: llm_text 包含被截断的文本。
  • 模型拒绝回答: llm_text 包含它回复的其他内容。

示例场景:使用 OpenAI 草拟浏览放弃邮件内容

Anchor link to

一个团队希望浏览放弃邮件以关于访客查看的特定产品的一行文字开头,而不是通用的“回来看看”主题。

  1. 添加一个基于触发器的入口元素,并将其设置为在 ProductViewedNoPurchase 事件上触发。
  2. 紧随其后添加 OpenAI: generate text。在 Prompt 中,写入 写一句简短的话,向查看过但未购买的购物者推荐 {{tag:Last Viewed Product}}。
  3. 紧随其后添加一个 Send Email 步骤,使用动态内容将 llm_text 插入到邮件正文中。

运行后,每位访客都会收到一封关于他们所查看的确切产品的邮件开场白,而不是整个细分市场都使用一条通用的开场白。