コンテキストと添付ファイルを提供する

Pilot は、プロンプトとともに関連するコンテキストを提供すると、より良い結果を生成します。このページでは、添付できるコンテキストの種類と、効果的なプロンプトを作成するためのベストプラクティスを説明します。

オントロジーのコンテキスト

既存のオントロジーエンティティをプロンプトに添付すると、Pilot は重複するエンティティを作成する代わりに、既存のデータモデルを使用できます。これは、オントロジーにすでにあるデータを拡張する、またはそのデータと統合するアプリケーションを作成する場合に特に役立ちます。

次の手順でオントロジーのコンテキストを添付します。

1. チャットパネルで追加を選択します。
2. 添付するエンティティの種類を選択します。
   • オブジェクトタイプ： オントロジーの既存のオブジェクトタイプ
   • アクションタイプ： オントロジーの既存のアクションタイプ
   • 関数： 既存の Foundry 関数（利用可能な場合）
3. 含めるエンティティを検索して選択します。

選択したエンティティは、プロンプト入力欄の下にあるコンテキスト領域にタグとして表示されます。各タグには、エンティティ名と編集権限を示すインジケーターが表示されます。

ドキュメントのアップロード

ドキュメントをアップロードして、アプリケーションに関する追加のコンテキストを提供できます。サポートされている形式は次のとおりです。

• PDF： 要件ドキュメント、仕様書、データ辞書
• Markdown： 技術ドキュメント、API リファレンス
• プレーンテキスト： メモ、要件、その他のテキスト形式の参考資料

ドキュメントをアップロードするには、チャットパネルで追加を選択し、ファイルを選択します。チャットパネルにファイルをドラッグアンドドロップしたり、クリップボードからコンテンツを貼り付けたりすることもできます。

Pilot はアップロードされたドキュメントを読み取り、アプリケーションの設計と実装に活用します。

画像のアップロード

画像をアップロードして、Pilot のデザインとレイアウトの決定に指針を与えることができます。一般的なユースケースは次のとおりです。

• 再現または改善したい既存のアプリケーションのスクリーンショット
• 希望するレイアウトを示すワイヤーフレームやモックアップ
• カラーパレットやコンポーネントのスタイルを示すデザインシステムの参考資料

Pilot はアップロードされた画像を解釈し、視覚的な要素をデザイン仕様とフロントエンドの生成に取り入れます。画像をアップロードするには、追加を選択してファイルを選択するか、クリップボードから画像を直接貼り付けます。

効果的なプロンプトを作成するためのヒント

プロンプトの品質は、生成されるアプリケーションの品質に直接影響します。次のガイドラインを参考にしてください。

• データモデルを具体的に説明する： アプリケーションに必要なエンティティ、プロパティ、関係を説明します。たとえば、Build a project tracker の代わりに、Build a project tracker with projects that have a name, description, status (Active, Completed, On Hold), and a list of tasks with priorities and due dates を試してください。
• 画面だけでなく、ユーザーのワークフローを説明する： インターフェースの外観だけでなく、ユーザーが何をできるべきかを説明します。例：Users should be able to filter tasks by status and assignee, drag tasks between status columns, and receive a notification when a task is overdue。
• アップロードしたコンテキストを参照する： ドキュメントや画像を添付する際は、その内容と、Pilot がそれらをどのように使用すべきかを説明します。例：Use the attached wireframe as the layout for the main dashboard. The sidebar should match the navigation structure shown in the image。
• 段階的に改善する： 一度にすべてを説明しようとするのではなく、中核となる機能から始め、追加のプロンプトで機能を追加します。