名称： pltr-cli
描述： 帮助您使用 pltr CLI 与 Palantir Foundry 进行交互。当您需要查询数据集、管理编排构建、处理本体、运行 SQL 查询、管理文件夹/空间/项目、复制数据集或在 Foundry 中执行管理操作时使用此技能。触发词：Foundry, pltr, dataset, SQL query, ontology, build, schedule, RID。

pltr-cli: Palantir Foundry 命令行工具

此技能帮助您有效地使用 pltr-cli 与 Palantir Foundry 交互。

兼容性

• 技能版本: 1.1.0
• pltr-cli 版本: 0.12.0+
• Python: 3.9, 3.10, 3.11, 3.12
• 依赖项: foundry-platform-sdk >= 1.69.0

概述

pltr-cli 是一个功能全面的 CLI，包含 100 多个命令，涵盖：
- 数据集操作：获取信息、列出文件、下载文件、管理分支和事务
- SQL 查询：执行查询、导出结果、管理异步查询
- 本体：列出本体、对象类型、对象，执行操作和查询
- 编排：管理构建、作业和计划
- 文件系统：文件夹、空间、项目、资源
- 管理：用户、组、角色管理
- 连接性：外部连接和数据导入
- 媒体集：媒体文件管理
- 语言模型：与 Anthropic Claude 模型和 OpenAI 嵌入交互
- 流：创建和管理流数据集，发布实时数据
- 函数：执行查询和检查值类型
- AIP 代理：管理 AI 代理、会话和版本
- 模型：用于模型和版本管理的 ML 模型注册表

核心概念

基于 RID 的 API

Foundry API 是基于 RID 的（资源标识符）。大多数命令都需要 RID：
- 数据集：ri.foundry.main.dataset.{uuid}
- 文件夹：ri.compass.main.folder.{uuid}（根目录：ri.compass.main.folder.0）
- 构建：ri.orchestration.main.build.{uuid}
- 计划：ri.orchestration.main.schedule.{uuid}
- 本体：ri.ontology.main.ontology.{uuid}

用户必须提前知道 RID（可从 Foundry Web 界面或之前的 API 调用获取）。

身份验证

在使用任何命令之前，请确保已配置身份验证：

# 交互式配置
pltr configure configure

# 或使用环境变量
export FOUNDRY_TOKEN="您的令牌"
export FOUNDRY_HOST="foundry.company.com"

# 验证连接
pltr verify

输出格式

所有命令都支持多种输出格式：

pltr <命令> --format table    # 默认：富文本表格
pltr <命令> --format json     # JSON 输出
pltr <命令> --format csv      # CSV 格式
pltr <命令> --output file.csv # 保存到文件

配置文件选择

使用 --profile 在不同 Foundry 实例之间切换：

pltr <命令> --profile production
pltr <命令> --profile development

参考文件

根据用户的任务加载以下文件：

工作流文件

针对常见的多步骤任务：

常用命令速查

# 验证设置
pltr verify

# 当前用户信息
pltr admin user current

# 执行 SQL 查询
pltr sql execute "SELECT * FROM my_table LIMIT 10"

# 获取数据集信息
pltr dataset get ri.foundry.main.dataset.abc123

# 列出数据集中的文件
pltr dataset files list ri.foundry.main.dataset.abc123

# 从数据集下载文件
pltr dataset files get ri.foundry.main.dataset.abc123 "/path/file.csv" "./local.csv"

# 将数据集复制到另一个文件夹
pltr cp ri.foundry.main.dataset.abc123 ri.compass.main.folder.target456

# 列出文件夹内容
pltr folder list ri.compass.main.folder.0  # 根文件夹

# 搜索构建
pltr orchestration builds search

# 交互式 Shell 模式
pltr shell

# 向 Claude 模型发送消息
pltr language-models anthropic messages ri.language-models.main.model.xxx \
    --message "解释这个概念"

# 生成嵌入
pltr language-models openai embeddings ri.language-models.main.model.xxx \
    --input "示例文本"

# 创建流数据集
pltr streams dataset create my-stream \
    --folder ri.compass.main.folder.xxx \
    --schema '{"fieldSchemaList": [{"name": "value", "type": "STRING"}]}'

# 向流发布记录
pltr streams stream publish ri.foundry.main.dataset.xxx \
    --branch master \
    --record '{"value": "hello"}'

# 执行函数查询
pltr functions query execute myQuery --parameters '{"limit": 10}'

# 获取 AIP 代理信息
pltr aip-agents get ri.foundry.main.agent.abc123

# 列出代理会话
pltr aip-agents sessions list ri.foundry.main.agent.abc123

# 获取 ML 模型信息
pltr models model get ri.foundry.main.model.abc123

# 列出模型版本
pltr models version list ri.foundry.main.model.abc123

最佳实践

1. 始终先验证身份验证：开始工作前运行 pltr verify
2. 使用合适的输出格式：编程使用 JSON，电子表格使用 CSV，可读性使用表格
3. 对大型查询使用异步：长时间运行的查询使用 pltr sql submit + pltr sql wait
4. 导出结果：使用 --output 保存结果以供进一步分析
5. 使用 Shell 模式进行探索：pltr shell 提供 Tab 补全和历史记录

获取帮助

pltr --help                    # 所有命令
pltr <命令> --help          # 命令帮助
pltr <命令> <子命令> --help    # 子命令帮助