注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Pilot では、アプリケーションコード、オントロジー定義、プレビューデータ、エージェントのコンテキストが分離されています。構築とテストの際には、それぞれを個別に確認します。
選択したデータソースによって、プレビューで読み取るレコードと、オントロジーのアクションが適用される場所が決まります。
| データソース | プレビューの動作 | 用途 |
|---|---|---|
| 仮想データ | コンテナのローカルモックデータストアに生成されたサンプルレコードを使用します。 | 実際のレコードに接続する前に、インターフェースを構築してテストします。 |
| 本番データ | Foundry オントロジーのメインブランチを使用します。アクションによって実際のオブジェクトが変更される可能性があります。 | デプロイ済みのリソースと実際のデータを使ってアプリケーションを検証します。 |
| ブランチ上の本番データ | デプロイのプレビュー用に選択された Foundry ブランチを使用します。 | 提案されたオントロジーの変更を検証し、そのブランチ上でアクションをテストします。 |
カスタムウィジェットでは、ブランチのプレビューを示すインジケーターはブランチデータです。
エディターとデプロイはワークスペースのビューであり、データを分離する境界ではありません。サポートされている場合、エディターには仮想データ / 本番データのコントロールが表示されます。デプロイビューでは、メインブランチまたは選択した Foundry ブランチの本番データを選択します。
プレビューで本番データを使用しているときに実行したアクションによって、実際のオブジェクトが作成、変更、削除される可能性があります。これは、エディタービューや、リポジトリが別のコードブランチ上にある場合にも当てはまります。
Pilot は、アプリケーションのローカルモックデータストア用のサンプルレコードを生成できます。これらのレコードはシードデータと呼ばれ、プレビューのコントロールでは仮想データの下に表示されます。オントロジータブのデータプレビューで確認し、必要に応じて Pilot に調整を依頼します。
オントロジーのデータプレビューには、アプリケーションのプレビューで本番データを使用している場合でも、ローカルのサンプルレコードが表示されます。フロントエンドをデプロイしても、シードデータが本番のオントロジーデータとして公開されることはありません。
モックレスポンスはインターフェースの構築に役立ちますが、本番環境の権限、実際の関数の結果、または実行時のすべての動作を検証するものではありません。これらは、使用する予定のデータソースに対して個別にテストしてください。
本番データのプレビューでは、デプロイ済みのオントロジーリソースと、利用可能なアクセス権が使用されます。提案されたリソースやプロパティは、まだそこに存在しない可能性があります。Pilot に未デプロイの提案を示すバナーが表示された場合は、必要なオントロジーの変更を実装するか、仮想データに戻します。
プレビューが空の場合、データがない、権限がない、または定義が未デプロイである可能性があります。必ずしもフロントエンドに不具合があることを意味するわけではありません。
Foundry ブランチを使用すると、サポートされているオントロジーの変更について、その定義をメインブランチにマージする前にテストできます。アクションがブランチ上で編集を適用するには、そのアクションで編集するオブジェクトタイプがブランチ上でインデックス化済みである必要があります。
ブランチでのテスト中にアクションによって行われた編集は、メインブランチにマージされません。オントロジーの提案のマージと、テストレコードの本番環境への移動は別の操作です。
Webhook、外部呼び出し、または通知を伴うアクションには、ブランチ固有の追加の動作があります。これらのワークフローをテストする前に、アクションタイプのブランチ化を確認してください。
コードブランチは、リポジトリ内のファイルをバージョン管理します。プレビューのデータソースを変更したり、本番データの分離されたコピーを作成したりするものではありません。
Foundry ブランチは、サポートされているプラットフォームリソースをバージョン管理し、オントロジーのテスト用のブランチコンテキストを提供します。その提案は、Pilot の変更ビューに表示されるコードの提案とは別です。
コードでの共同作業についてはブランチ、変更、提案を、オントロジーのデプロイについてはアプリケーションをデプロイするを参照してください。
オントロジーの権限は、Pilot が新しい定義を提案したり、既存の定義を変更したりできるかどうかを制御します。実際のレコードへのアクセス権の付与、アクションの認可、または変更をデプロイする権限の付与を行うものではありません。
選択したデータソースと、基盤となる Foundry の権限を個別に確認します。Pilot が変更できる内容を制御するを参照してください。
本番データの分析は、お使いの Pilot 環境でサポートされ、有効になっている場合にのみ利用できます。
利用可能な場合、Pilot は、本番オブジェクトの読み取り専用の分析を、別のエージェントコンテキストで動作する本番データ閲覧エージェントに委任できます。そのエージェントは、レコードを確認し、統計を集計して、データの特徴を把握するのに役立てることができます。本番データのプレビューと、この分析のリクエストは別のワークフローです。
アプリケーションを構築するエージェントに分析を共有する前に、Pilot は本番データ分析のレビューカードを表示します。
この時点で、本番データ閲覧エージェントはすでに実際のデータを分析しています。承認は、アプリケーションを構築するエージェントへの分析の共有を制御するものであり、最初のデータ読み取りを承認するものではありません。分析に機密情報が含まれていないと思い込まず、実際のテキストを確認してください。
承認後、完了したカードで分析を表示を選択すると、承認済みの内容を確認できます。分析が利用できなくなった場合は、Pilot に新しい分析の作成を依頼します。
公開する前に、次の点を確認します。