rowset

Rowset

目的

Rowset は、ユーザーが所有する構造化データセットの安定したバックエンドとして使用できます。Rowset は MCP、Rowset CLI、REST API を通じて利用できます。これらは、同じアカウントとデータを扱う同等のインターフェースとして捉えてください。セットアップ時は、プライベートなベアラーシークレット設定がある場合に限りネイティブのリモート MCP を優先し、信頼できるターミナルやローカルファイルを使うワークフローでは CLI に切り替え、コードのみ、または HTTP のみのランタイムでは REST を使用してください。

このスキルは、アクセス設定後に Rowset を利用するための継続的なガイドです。エージェントがランタイムの確認、インターフェースの選択と設定、認証情報の保存、認証の検証、初回の有効化をまだ行う必要がある場合は、rowset-setup を使用してください。

Rowset は急速に進化しているため、静的な例を機能やコマンドの完全なリファレンスとして扱わないでください。最新のスキーマ、コマンド、エンドポイント、ワークフローを確認するには、ライブの機能情報とインターフェースのドキュメントを使用してください。

現在の機能の確認

機能の確認はタスクに応じて行い、起動時のチェックリストとしては行いません。セッションが開始したというだけで、機能情報を読み込んだりデータセットを一覧表示したりしないでください。静的な機能カタログを維持するのではなく、タスクで必要な場合にのみ、最新のライブリソースを使用してください。

• MCP：正確な入力を確認するには、ライブのツールスキーマを使用してください。機能に不慣れな場合、またはセットアップに失敗している場合に限り、get_rowset_capabilities を呼び出して簡潔なトピック一覧を取得し、関連する topics のみをリクエストしてください。
• CLI：実行する操作のコマンドヘルプを確認してください。より広範なワークフローのガイダンスが必要な場合に限り、引数なしの rowset capabilities を使用し、--topic を繰り返し指定してください。
• REST：対象のエンドポイントについて、生成された API ドキュメントを参照してください。より広範なワークフローのガイダンスが必要な場合に限り、/api/capabilities を読み、?topics=... で詳細をリクエストしてください。
• すべてのインターフェースで、ユースケースはオプトインです。full モードではトピックによるフィルタリングを行わず、ガイド全体を取得します。
• どのインターフェースでも、最新のドキュメント、ガイド、スキル、ユースケース、リリース関連のリソースを見つけるには、Rowset の llms.txt を使用してください。
• 最新の製品ガイダンス、例、判断ガイド、進化するワークフローの推奨事項については、Rowset のドキュメントとブログのインデックスを使用してください。

ユーザーからデータセットのキーまたは URL が指定された場合は、そのデータセットを直接確認してください。MCP の get_dataset はどちらの値も受け付けます。CLI または REST の場合は、URL からデータセットキーを抽出してから、rowset dataset get または /api/datasets/{dataset_key} を使用してください。対象のデータセットが不明な場合は、上限を明示して 3 件を検索し、1 件を選んだうえで、現在のスキーマ、手順、メタデータ、リレーションシップ、インデックスのセマンティクスを確認してください。重複を作成する前に検索してください。新しいデータセットに安定したビジネスキーがない場合は、ライブ機能ガイドに記載されている Rowset の最新の ID 自動生成方法を使用してください。

Rowset の使用

• このユーザー用にすでに設定されているインターフェースを再利用してください。そのインターフェースがランタイムでサポートされなくなった場合は、rowset-setup の選択プロセスを再実行してください。
• 同じ所有権、検証、インデックス、プライバシーのルールに従い、REST と MCP の動作を一致させてください。
• データセットの手順、メタデータ、セマンティックスキーマ、リレーションシップ、インデックス設定は、装飾ではなく、継続的に適用される運用上のコンテキストとして扱ってください。
• インデックス列は安定しており、一意で、明示的なものにしてください。ソースに信頼できるビジネスキーがない場合は、Rowset の ID 自動生成方法を使用してください。
• 新しいものを作成する前に、上限を明示して既存のプロジェクトとデータセットを 3 件検索してください。関係のないリソースを列挙しないでください。
• データセットの行を読み取ったり変更したりする前に、そのデータセットの現在の詳細を確認してください。
• 破壊的な操作を行う前、および公開共有の状態を変更する前に、ユーザーに確認してください。

安全ルール

• 認証済みデータセットは、デフォルトで非公開にしてください。
• ユーザーのタスクに必要な Rowset リソースのみを使用してください。
• 行やデータセットの削除、リソースのアーカイブ、プレビュー用パスワードの消去、意味のあるデータの置き換えなど、破壊的な操作を行う前に確認してください。
• 公開プレビューを有効にしたり変更したりする前に確認してください。
• API キー、OAuth トークン、生のシークレット、非公開データセットの内容を公開しないでください。
• 公開プレビューは読み取り専用の共有手段であり、認証機能ではありません。また、非公開の MCP、CLI、REST によるアクセスの代替ではありません。
• エージェントの作業では、ブラウザーの自動操作よりプログラムによる Rowset インターフェースを優先してください。
• 現在の Rowset リソースで確認できない機能について、利用可能だと主張しないでください。

関連スキル

• rowset-setup はアクセスを設定し、認証を確認し、初回実行時のアクティベーションの引き継ぎを完了します。
• rowset-features は現在の機能範囲の解釈に役立ちます。
• rowset-use-cases はデータセットのパターン例を提供します。実装する前に、各例が現在の Rowset の機能で利用できることを確認してください。