coral

Coral

概要

外部コンテキストを取得する際の Coral のエントリーポイントとして使用してください。ライブの外部状態が重要な場合は、前提に基づいて回答したり、コードを変更したりする前に Coral に問い合わせてください。

• 検出とクエリには Coral MCP ツール／リソースを使用してください。
• 明示的に依頼された場合を除き、coral CLI の使用、Coral のコンパイル、バイナリのコピー、サーバーのブートストラップは行わないでください。
• ユーザーから Coral を使わずに続行するよう依頼された場合、または Coral が対象の情報源に対応していない場合を除き、同じ情報の読み取りにベンダーのツールへ切り替えないでください。

サポート状況の確認

• 外部システムについて主張する前に、Coral MCP のツール／リソースを確認してください。
• Coral MCP を利用できない場合は、障害要因を伝えて停止してください。ローカルでの復旧は行わないでください。
• 情報源の設定不足、認証情報の不足、クエリエラー、結果が空であることを区別してください。
• スコープが指定されていない場合は、まずガイダンスを確認してから、不足している識別子のうち必要最小限のものを尋ねてください。

ワークフロー

1. ユーザーの依頼から、必要な情報源、エンティティ、スコープを特定します。
2. search で関連するテーブル、テーブル関数、列、フィルターを検出します。カタログ、スキーマ、種類で絞り込んだページ分割済みのカタログ一覧が必要な場合は、list_catalog を使用します。
3. 正確なメタデータが必要な場合は、schema と単独の surface 名を指定して describe を使用します。3 部構成のテーブルの場合は catalog も追加します。Coral が対象をテーブルかテーブル関数か判定します。正確な応答では対象が再掲されず、メタデータのみが返されるため、リクエスト対象または先行する検出結果を保持してください。kind、guide、required_filters、関数の引数、結果列を確認します。クエリパターンには coral://guide、テーブルの概要には coral://tables を使用します。
4. テーブルの列、必須フィルター、仮想列、説明を確認するには、coral.columns を調べます。
5. 情報源に応じた関数のガイド、引数、結果列を確認するには、coral.table_functions を調べます。
6. 情報源の設定が回答に影響する場合は、coral.inputs を調べます。
7. sql でクエリを実行します。有用な列を選択し、必須フィルターまたは関数の引数を含め、完全な出力を求められていない限り LIMIT を追加します。
8. 根拠、不足情報、次のアクションを要約します。コードを編集する場合は、Coral の結果を変更の指針にしてください。

クエリのルール

• 各テーブルで sql_reference が利用可能な場合は、それを使用してください。catalog_name が空の場合は schema_name.table_name、空でない場合は catalog_name.schema_name.table_name を使用します。識別子はそれぞれ個別に引用符で囲み、完全修飾参照全体を囲まないでください。
• 各テーブル関数では sql_call_example を使用し、必須の引数を埋めてからクエリを実行してください。
• メタデータの検出は範囲を限定してください。カタログの検出ではページ分割し、可能であれば coral.columns には 1 つのテーブルを、coral.table_functions には 1 つの情報源を指定してください。広範なメタデータを直接読み取る場合は LIMIT を追加します。
• 仮想列はフィルター専用で、NULL を返します。is_virtual を確認してください。
• 必須フィルターは WHERE に含める必要があります。required_filters と is_required_filter を確認してください。
• シークレット入力では常に value = NULL が返されます。is_set を使用してください。
• 情報源をまたぐ結合は可能で、情報源のスキャン完了後にローカルで実行されます。
• 回答は簡潔にまとめ、情報源、テーブル、必須フィルター、クエリの形式を示してください。依頼されていない限り、列を網羅的に列挙しないでください。
• 回答または障害要因から先に示してください。ユーザーが結果を信頼または再利用するうえで役立つ場合にのみ、SQL を含めてください。

境界

• マニフェストへのフォールバックは依頼された場合に限ります。関連する最小限のセクションを確認し、テーブルとフィルターの構成を要約してください。
• マニフェストの大きな抜粋を貼り付けたり、クエリで確認した範囲を示さずに情報源全体について結論を述べたり、クエリの失敗を結果が空であることとして扱ったりしないでください。

フィードバック

MCP の feedback ツールが利用可能な場合、Coral が作業を妨げる、生産性の低いパターンを促す、または同じ情報の読み取りにベンダーのツールを使うほうが簡単だったときは、フィードバックを送信してください。

trying_to_do、tried、stuck を含め、テーブル名／情報源名、クエリの抜粋、エラーテキストを記載してください。通常の結果なしや認証情報の不足については、Coral が問題を分かりにくくしていた場合を除き、フィードバックを送信しないでください。