pltr-cli

核心用法

pltr-cli技能是一个纯文档型AI助手，专门指导用户通过Palantir官方pltr CLI工具与Foundry企业数据平台交互。该技能覆盖100+CLI命令的完整使用场景：数据集操作（信息查询、文件下载、分支管理）、SQL执行与异步查询、本体(Ontology)对象管理、编排调度（构建/作业/计划）、文件系统（文件夹/空间/项目）、用户权限管理、实时流数据处理、AIP智能体交互以及ML模型注册表管理等。用户通过自然语言描述需求，技能自动加载对应的参考文档（reference/.md）或工作流指南（workflows/.md），生成精确的CLI命令示例。

显著优点

企业级功能覆盖：作为Palantir Foundry的官方CLI封装，支持从数据探索到生产部署的全链路操作，包括独特的RID资源标识体系、多格式输出（table/json/csv）、多环境配置切换等高级特性。

零执行风险设计：纯Markdown文档架构，无Python/JS/Shell可执行代码，所有命令均需用户手动在本地CLI执行，从根本上杜绝代码注入和未授权操作风险。

结构化知识组织：按任务类型智能路由参考文件（如SQL查询→sql-commands.md，权限管理→permission-management.md），大幅降低学习成本。

AI原生集成：内置对Anthropic Claude模型和OpenAI嵌入的调用支持，以及AIP Agents的会话管理能力，实现数据平台与大语言模型的无缝衔接。

潜在缺点与局限性

RID依赖门槛：Foundry API强制使用RID（资源标识符），用户必须预先从Web UI或API获取，无法通过自然语言直接定位资源，增加使用摩擦。

外部工具依赖：技能本身不执行任何操作，用户需自行安装配置pltr-cli（0.12.0+）和Python 3.9-3.12环境，并管理FOUNDRY_TOKEN等认证凭据。

无实时验证能力：无法检测用户输入的RID是否有效、Token权限是否充足，错误只能在CLI执行后暴露。

平台锁定：深度绑定Palantir Foundry专有生态，学习成果难以迁移至其他数据平台。

适合的目标群体

• 数据工程师：构建ETL管道、管理数据血缘、调度生产作业
• 数据分析师：执行即席SQL查询、探索数据集、导出分析结果
• 平台管理员：用户/组织管理、权限配置、资源治理
• ML工程师：模型版本管理、AIP智能体部署、嵌入服务调用
• 已有Foundry许可的企业团队：需通过CLI自动化重复性平台操作

使用风险

凭证管理风险：文档建议通过环境变量配置FOUNDRY_TOKEN，若用户误将Token硬编码到脚本或提交至版本控制，可能导致凭据泄露。

操作不可逆风险：指导的删除命令（数据集、资源、用户权限）在Foundry中可能立即生效且无回收站机制，需用户自行确认目标。

数据合规风险：SQL查询和文件下载可能涉及敏感数据，用户需确保本地环境符合企业数据安全策略。

CLI版本兼容性：技能基于pltr-cli 0.12.0+设计，若用户使用过旧版本，部分命令语法可能不兼容。

pltr-cli 是一个专为 Palantir Foundry 用户设计的 CLI 参考手册型技能。它本质上是一套详尽的命令行操作指南，覆盖了数据集操作、SQL 查询、本体管理、编排构建、文件系统管理、用户管理及模型注册等 100 余条命令。

核心用法：
该技能通过结构化的 Markdown 文档，提供了触发不同任务（如数据探索、ETL 流水线、权限管理）时需要加载的参考文件路径及常用命令示例。它并非一个可执行的脚本，而是作为 Agent 的“记忆与索引”，指导 Agent 在用户提出“查询数据集”、“管理构建”等需求时，准确地生成 pltr CLI 命令供用户参考或使用。

显著优点：
1. 安全性极高：经过安全认证，该技能为纯文档型，无可执行代码、无外部依赖、无网络调用，完全不会触发任何安全扫描威胁，是极其安全的 Agent 技能。
2. 覆盖面广：系统性地索引了 Palantir Foundry 平台的几乎所有 CLI 操作，从基础的数据集下载到高级的 AI 代理管理，均可提供正确的命令语法和参数指引。
3. 结构化强：命令按功能模块（数据集、SQL、本体等）分类组织，并提供了快速参考和工作流文件，便于 Agent 快速定位并给出高精度、符合平台规范的指令。
4. 低风险实现：所有代码块均为 Bash 示例，本身不执行任何操作，完全消除了命令注入或权限滥用的可能。

潜在缺点或局限性：
1. 纯静态参考：技能完全依赖内置的命令示例，无法动态获取最新的 CLI 功能或参数变更。若用户本地的 pltr 版本过新或过旧，示例命令可能存在差异。
2. 高门槛依赖：所有操作基于 Palantir Foundry 的资源标识符，且用户必须提前知晓并手动输入这些 RID，对于不熟悉 Foundry 平台的用户而言，使用门槛较高。
3. 来源可信度的潜在疑虑：作者虽为前 Palantir 员工，但该技能为个人开发者的开源项目，仓库 Star 数较少，来源可信度为 T3 级别。

适合的目标群体：
该技能特别适合已部署 Palantir Foundry 的企业内部的数据工程师、数据科学家以及 DevOps 工程师。它完美适配那些希望通过 AI Agent 辅助，高效、安全地执行日常平台运维、数据探索和 Pipeline 管理任务的专业技术团队。

使用该技能可能存在的常规风险：

• 认证凭证风险：技能在文档中会引导用户配置 FOUNDRY_TOKEN 等敏感凭证。虽然技能本身不窃取凭证，但若用户因错误的指导将凭证硬编码或暴露在共享环境中，将带来极高的安全风险。
• 高权限误操作风险：文档中包含 admin、resource-role 等高权限命令示例。Agent 可能在没有充分风险评估的情况下，向用户推荐执行这类拥有巨大破坏力的命令，导致数据删除或权限混乱。
• 代码失效风险：由于缺乏版本动态适配机制，Agent 照本宣科给出的命令可能在其用户的 Foundry 环境中不可用或行为不符合预期，导致任务失败或产生难以排查的逻辑错误。