pi-grok-sdk
pi环境下通过本地xAI CLI调用Grok Build的SDK
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-grok-sdk。 它的用途是：pi环境下通过本地xAI CLI调用Grok Build的SDK 完整的 Skill 内容见：https://321skill.com/skills/pi-grok-sdk/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前pi项目中引入pi-grok-sdk，实现Grok流式对话功能”，它会自动生成SDK引入代码、CLI环境校验逻辑与流式输出渲染模板。
对AI说：“帮我配置多轮ACP会话的上下文保持逻辑”，它会基于SDK封装会话状态管理模块，自动维护多轮交互的上下文信息。
介绍
以往在pi环境中想要使用Grok Build的原生AI能力，需要自行完成跨环境接口适配、会话状态维护、流数据解析等工作，开发成本较高，还容易出现流式输出卡顿、多轮会话上下文丢失、工具调用权限不通等问题，该SDK直接封装了底层对接逻辑，免去开发者自行适配的冗余工作。 使用时需先在本地完成xAI agent CLI的安装与账号授权，再通过npm安装该SDK，即可在pi项目中引入对应接口发起调用，支持原生思考过程、文本内容的流式返回，也能维持多轮ACP会话状态，直接调用Grok自带的agent工具集。 它适合需要在pi相关项目中集成Grok AI能力的前端、全栈开发者，以及想要基于Grok Build搭建自定义AI工作流、需要用到多轮agent交互的技术爱好者，还有需要在本地环境调试xAI相关能力的研发人员。 使用前请确保本地xAI agent CLI的环境变量配置正确，若需要用到专属agent工具，需提前在xAI侧开通对应权限；在流式输出场景下，建议做好前端的分段渲染适配，进一步提升交互体验。
核心特点
不同于通用Grok API调用工具，它直接对接本地xAI agent CLI，原生适配pi运行环境，无需额外开发即可支持ACP多轮会话与思考、文本双流输出。
注意事项
仅能在已正确安装配置xAI agent CLI的本地环境中使用，无法脱离本地CLI直接调用云端Grok接口。
常见问题
使用pi-grok-sdk必须提前安装xAI agent CLI吗？
是的，该SDK依赖本地部署的xAI agent CLI完成能力对接，需提前安装并完成授权配置。
是否支持输出Grok的思考过程？
支持，SDK原生适配了Grok思考链路与文本内容的双流输出能力。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-grok-sdk/raw/index.md 读取 pi-grok-sdk 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-grok-sdk/raw/index.md（查看排版版本）