GrokPrompt 提示驱动配置与 xAI Grok 系列模型连接节点

xAI API 调用必须绑定账单支付方式

GrokPrompt 节点要求在 xAI 官方平台必须完成账户注册并成功绑定账单计费信息 (Billing)，生成的 API Key 方可生效。如果未完成账单绑定，即使填入了看似有效的 API 密钥，任何尝试调用 xAI 服务的节点也会立即报错失败。详细配置流程请参阅 xAI Grok 集成指南。

节点核心功能 (What is it?)

GrokPrompt 驱动节点专用于在 Griptape 流程中建立与 xAI 的 Grok 系列前沿大模型的高性能连接与参数调控。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

在自动化工作流管线中引入 xAI Grok 的对话、推理与多模态理解能力；
定制和微调 Agent 智能体调用 Grok 模型的交互协议与生成策略；
针对时事新闻推理、深度思考或特定幽默直率的表达风格调动 Grok 推理引擎。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在工作流画布中添加 GrokPrompt 节点。
将其输出引脚连接至需要提示驱动的节点（例如 Agent 智能体节点）。

参数输入插槽 (Parameters)

model：目标调用的 Grok 模型版本标识：
- 默认推荐："grok-3-beta"；
- 可选范围："grok-3-beta"、"grok-3-fast-beta"、"grok-3-mini-beta"、"grok-3-mini-fast-beta"、"grok-2-vision-1212"。
top_p（浮点数，默认 0.9）：核采样截断概率，调控候选 Token 的词汇丰富度。
stream（布尔值）：流式传输开关（true 即时按 Token 流式吐出，false 等待完整生成后一次性返回）。
temperature（浮点数）：采样发散度系数（值越高输出越奔放，值越低输出越严密聚焦）。
max_attempts_on_fail（整数）：网络抖动或限流报错时的最大自动重试尝试次数。
use_native_tools（布尔值）：是否开启模型原生的工具调用（Function Calling）接口。
max_tokens（整数）：单次生成响应的最大 Token 长度限制。

输出引脚 (Outputs)

prompt_model_config：打包封装就绪的 Grok 提示驱动配置工件，供 Agent 等下游算子直接挂载消费。

典型工作流示例 (Example)

为智能体挂载 Grok-3 思考模型：

添加一个 GrokPrompt 节点至画布。
将其输出端 prompt_model_config 连接至 Agent 节点的对应输入插槽。
Agent 即可依托 Grok 强大的推理引擎与定制参数开始工作。

推荐尝试的调优组合： - 将 model 从 "grok-3-beta" 切换至轻量高频的 "grok-3-mini-beta"； - 将 top_p 设为 0.7（使模型回答更加严谨、聚焦关键事实）。

关键技术特性 (Important Notes)

API 凭据配置：需要在运行环境中配置有效的 Grok API 密钥（环境变量 GROK_API_KEY）。
参数特性差异：与部分其他驱动不同，xAI Grok 原生接口暂不支持 seed（固定随机种子）与 top_k 参数。
商业计费前置：Grok API 为纯商业付费服务，必须在 xAI 官网控制台完成充值绑定后方可调用。