跳到内容

Gemini:生成文本

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

典型用途:

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

配置节点

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

    • gemini-2.5-flash-lite: 默认选项。
    • gemini-2.5-flash: 每个 token 的成本比 Flash Lite 高。

    此处不提供 Gemini 2.5 Pro:它无法关闭自身的推理步骤,因此不能保证在节点的 10 秒超时内完成。

    每个到达此步骤的旅行者的每次调用都会计费到您自己的 Gemini 密钥。

模型字段设置为 gemini-2.5-flash-lite,并附有 Pro 排除说明
  1. 在 Prompt 中,写下您希望模型生成的内容。它接受与任何 Webhook 主体相同的宏,例如 {{device:hwid}}。
提示字段,其中包含使用标签宏的产品推荐提示
  1. 点击 Save。

推理功能已关闭,响应上限约为 300 个 token(大约一个短段落),以确保请求在 Webhook timeout 内完成。请要求简短的内容。更长或更详细的提示不会获得更多的回答空间。

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

步骤运行后的属性

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 包含模型回复的其他内容。

示例场景:使用 Gemini 在短信中起草订单跟进提示

Anchor link to

一个团队希望订单确认短信中不仅包含订单号,还包含一条简短的、特定产品的护理提示。

  1. 在确认订单的步骤之后立即添加 Gemini: generate text。在 Prompt 中,写入 Write one short care tip for someone who just bought {{tag:Last Purchased Category}}.
  2. 紧接着添加一个 Send SMS 步骤,使用 Dynamic Content 将 llm_text 插入到短信文本中。

运行后,每个订单确认信息都会包含与旅行者购买的商品相关的提示,而不是每笔订单都显示相同的文字。