オントロジータブ

Pilot ワークスペースのオントロジータブには、Pilot がアプリケーション用に作成または再利用したオントロジーのエンティティが、対話型グラフで表示されます。このタブを使って、データモデルの確認、エンティティの詳細の確認、シードデータのプレビューを行います。

オントロジーグラフ

オントロジーグラフは、次の情報を表示する対話型の可視化です。

• オブジェクトタイプのノード： アプリケーションの中核となるエンティティを表し、そのプロパティとともに表示されます。
• アクションタイプのノード： 各オブジェクトタイプで利用可能なアクションを表します。
• リンクタイプのエッジ： オブジェクトタイプ間の関係を示します。

パン、ズーム、ノードの選択によってグラフを探索できます。グラフでは、自動階層レイアウトを使ってノードとエッジを配置します。

エンティティのステータスの凡例

オントロジーグラフには、各エンティティの状態を示すステータスの凡例があります。

• 既存： Pilot が再利用しているオントロジー内のエンティティです。Pilot による変更も含まれます。
• 提案： Pilot が現在のセッションで作成したエンティティです。

エンティティのステータスでグラフを絞り込み、特定のカテゴリーに注目できます。

データプレビュー

オブジェクトタイプのノードを選択すると、データプレビューパネルが開きます。データプレビューパネルには、次の詳細が表示されます。

• オブジェクトタイプに定義されたプロパティ
• Pilot が生成したシードデータのサンプルレコード
• 利用可能なレコードの数

アプリケーションのプレビューで本番データを使用している場合でも、データプレビューはローカルのままです。データを操作するを参照してください。

データプレビューを使って、生成されたシードデータが期待どおりであることを確認します。データが正しくない場合は、チャットパネルで Pilot にシードデータの再生成または調整を依頼します。

Pilot が変更できる対象を制御する

既存のオントロジーを使用して構築する場合は、Pilot による変更を許可するエンティティと、新しいエンティティの作成を許可するかどうかを制御できます。これらの権限は、次の2か所からアクセスできるオントロジーの権限ダイアログで管理します。

• 構築を開始する前に、ウェルカム画面のプロンプト入力欄の下にあるオントロジーの権限を変更を選択します。
• オントロジータブに移動し、グラフの右上にあるオントロジーの権限を選択します。

これらの設定は、提案されるスキーマの変更を制御するものであり、オブジェクトの読み取り、アクションの実行、定義のデプロイの権限を付与するものではありません。保護されたコードブランチを使用している場合は、設定を変更する前に編集可能なブランチに切り替えてください。

デフォルトの権限

オントロジーの権限ダイアログでは、オブジェクトタイプとアクションタイプに対するデフォルトの動作を設定します。

• Pilot による新しいオブジェクトタイプ/アクションタイプの作成を許可： Pilot がまったく新しいエンティティを提案できるかどうかを制御します。無効にすると、Pilot はデプロイ済みのオントロジーにすでに存在するエンティティのみを使用して構築します。
• デフォルトの編集権限： 個別に設定していないエンティティに適用される権限です。Pilot によるエンティティの拡張を許可するには変更を許可を選択し、デプロイされたとおりに参照させるには変更を許可しないを選択します。

これらのデフォルトを更新しても、個々のエンティティに設定した権限は上書きされません。

エンティティごとの権限

デプロイ済みのオントロジー内の個々のオブジェクトタイプまたはアクションタイプに対して、Pilot による編集を許可するかどうかを指定できます。各エンティティのノードにあるドロップダウンメニューから、次のいずれかの選択肢を選びます。

• 変更を許可： Pilot は、プロパティ（オブジェクトタイプの場合）またはパラメーター（アクションタイプの場合）を追加および編集できます。これにより、オントロジー API に破壊的変更が生じる可能性があります。
• 変更を許可しない： Pilot はエンティティをデプロイされたとおりに参照し、そのスキーマを変更できません。

リンクタイプには独自の権限制御はなく、接続先のオブジェクトタイプの権限に従います。

本番のデータモデルを変更せずに Pilot がエンティティを使用して構築するようにしたい場合は、そのエンティティを変更を許可しないに設定します。後でロックされたエンティティの変更を必要とする依頼を行うと、Pilot は処理を一時停止し、どのように進めるかを確認します。その際に、Pilot による変更を許可する、Foundry で自分で変更する、またはエンティティをそのまま保持する、のいずれかを選択できます。

Pilot による新しいエンティティの作成が許可されておらず、すべてのエンティティが変更を許可しないに設定されている場合、オントロジーは完全にロックされます。Pilot は、デプロイ済みの既存エンティティと、その利用可能なデータおよびアクションのみを使用してアプリケーションを設計します。

チャットを通じてオントロジーを変更する

チャットパネルに指示を入力すると、オントロジーを変更できます。Pilot は、オントロジー設計に特化したエージェントを使用してオントロジーの変更を処理します。一般的な変更には、次のものがあります。

• オブジェクトタイプへの新しいプロパティの追加：Add a "due date" property to the Task object type
• 新しいオブジェクトタイプの作成：Create a Category object type with a name and description
• 関係の追加：Link each Task to a Category
• プロパティタイプの変更：Change the priority property from a string to an enum with values High, Medium, and Low

Pilot が変更を適用すると、オントロジーグラフが更新され、新しい構造が反映されます。その後、アプリ構築エージェントが、変更されたオントロジーを使用するようにフロントエンドコードを更新します。

検証エラーを解決する

オントロジー表示には、エンティティの定義、コードチェック、または編集権限チェックのエラーが表示されることがあります。報告された問題を開き、影響を受けるエンティティと制約を特定します。

これらのチェックは、デプロイ可能性に表示されるデプロイのドライランとは別のものです。デプロイ可能ステータスであっても、オントロジー表示に検証エラーがないことを意味するわけではありません。

Pilot にエラーの修正を依頼するか、編集可能なブランチでソースを更新します。オントロジーのデプロイブランチを作成する前に、検証を再実行してください。アプリケーションをデプロイするを参照してください。