rowset

Rowset

用途

将 Rowset 用作用户拥有的结构化数据集的稳定后端。可通过 MCP、Rowset CLI 或 REST API 使用 Rowset。请将它们视为同一账户和数据上的同级接口。设置期间，仅在使用私密 Bearer 密钥配置时优先采用原生远程 MCP；对于可信终端或本地文件工作流，回退到 CLI；对于纯代码或仅支持 HTTP 的运行环境，使用 REST。

配置好访问权限后，本技能是使用 Rowset 的长期指南。如果 Agent 仍需检查其运行环境、选择并配置接口、存储凭据、验证身份验证或完成首次激活，请使用 rowset-setup。

Rowset 发展迅速，因此不要将静态示例视为完整的功能或命令参考。请使用实时能力信息和接口文档，了解当前的架构、命令、端点和工作流。

当前能力发现

能力发现由任务驱动，而不是启动检查清单。不要仅仅因为会话启动就加载能力或列出数据集。只有当任务需要时，才使用当前的实时资源，而不要维护静态功能目录：

• MCP：使用实时工具架构获取准确的输入。仅当不熟悉某项功能或设置失败时，才调用 get_rowset_capabilities 获取精简的主题索引；随后仅请求相关的 topics。
• CLI：查看当前操作对应的命令帮助。仅当需要更广泛的工作流指南时，才使用裸命令 rowset capabilities 并重复指定 --topic。
• REST：查阅当前端点的生成式 API 文档。仅当需要更广泛的工作流指南时，才读取 /api/capabilities 并使用 ?topics=... 请求详细信息。
• 在各接口中，用例均为可选；完整模式会检索完整指南，不进行主题筛选。
• 任何接口：使用 Rowset 的 llms.txt 查找当前文档、指南、技能、用例和面向版本发布的资源。
• 使用 Rowset 文档和博客索引，获取当前产品指南、示例、决策指南和不断演进的工作流建议。

当用户提供数据集键或 URL 时，直接检查该数据集。MCP get_dataset 可接受这两种值。对于 CLI 或 REST，请先从 URL 中提取数据集键，再使用 rowset dataset get 或 /api/datasets/{dataset_key}。如果相关数据集未知，请明确将搜索上限设为 3，选定一个后，再检查其当前架构、说明、元数据、关系和索引语义。创建副本之前先搜索。如果新数据集没有稳定的业务键，请使用实时能力指南中记录的 Rowset 当前生成 ID 路径。

使用 Rowset

• 复用已为该用户配置的接口。如果运行环境不再支持该接口，请重新运行 rowset-setup 选择流程。
• 遵循相同的所有权、验证、索引和隐私规则，使 REST 与 MCP 的行为保持一致。
• 将数据集说明、元数据、语义架构、关系和索引设置视为持久的操作上下文，而非装饰信息。
• 保持索引列稳定、唯一且明确。如果来源没有可靠的业务键，请使用 Rowset 的生成 ID 路径。
• 创建新项目和数据集之前，使用明确设为 3 的上限搜索现有项目和数据集；不要枚举无关资源。
• 读取或更改数据集中的行之前，先检查该数据集的当前详情。
• 执行破坏性操作以及更改公开共享状态之前，请先征求确认。

安全规则

• 默认将已通过身份验证的数据集设为私有。
• 仅访问完成用户任务所需的 Rowset 资源。
• 执行删除行或数据集、归档资源、清除预览密码或替换有意义的数据等破坏性操作前，请先征求同意。
• 启用或更改任何公开预览前，请先征求同意。
• 不要泄露 API 密钥、OAuth 令牌、原始机密或私有数据集内容。
• 公开预览是只读的共享界面，不用于身份验证，也不能替代私有 MCP、CLI 或 REST 访问。
• 对于 Agent 工作，优先使用编程方式调用 Rowset 接口，而不是浏览器自动化。
• 除非当前的 Rowset 资源明确提供某项能力，否则不要声称该能力存在。

配套技能

• rowset-setup 用于配置访问权限、验证身份，并完成首次运行激活交接。
• rowset-features 帮助解读当前的能力范围。
• rowset-use-cases 提供数据集模式示例。实现前，请根据当前 Rowset 功能验证每个示例。