カスタムウィジェットを作成する

Pilot では、完全なアプリケーションだけでなく、カスタムウィジェットも作成できます。カスタムウィジェットは、独立したホスト型アプリケーションではなく、Workshop アプリケーション内に埋め込まれる、サンドボックス化されたフロントエンドコンポーネントです。ウィジェットの作成には、アプリケーションの作成と同じ会話形式のワークフローを使いますが、このページで説明する違いがあります。新しいプロジェクトを作成するには、はじめにを参照してください。

ウィジェットの作成をはじめる

Pilot のようこそ画面で、アプリケーションを作成するの代わりにカスタムウィジェットセットを選択し、作成したいウィジェットを説明して、ウィジェットセットを作成を選択します。Pilot は分離されたコンテナをプロビジョニングし、プロンプトからウィジェットを生成します。

アプリケーションを作成するときと同様に、チャットパネルで Pilot とチャットします。実行モードと計画モードを切り替えたり、コンテキストを添付したり、モデルを選択したりできます。

Pilot が生成するもの

Pilot は、Workshop アプリケーション内に表示されるウィジェットを生成します。1つのプロジェクトに複数のウィジェットを含めることができ、Pilot はそれらをまとめて1つのウィジェットセットとして公開します。Pilot は、次の2つの仕組みを通じて各ウィジェットをホストアプリケーションに接続します。

• パラメーター： オブジェクトセット、文字列、数値など、ウィジェットが Workshop から受け取る型付きの入力です。
• イベント： ユーザーのインタラクションに応じて変数を更新するために、ウィジェットが Workshop に発行する出力です。

Pilot は作成を進めながら、これらのパラメーターとイベントを定義します。ウィジェットとホストアプリケーションの通信の仕組みについては、パラメーターとイベントを参照してください。

ウィジェットは制限付きのサンドボックスで実行されます。Pilot にプロンプトを入力するときは、次の点に留意してください。

• ウィジェットは、ダークテーマを含む Workshop のテーマに合わせて表示されます。
• ウィジェットのサイズは、自動サイズ調整のルールに従います。
• ブラウザー機能へのアクセスと外部ネットワークへのリクエストは制限されています。追加のブラウザー機能をリクエストするには、追加の iframe 属性を有効にするを参照してください。

ウィジェットをプレビューする

プレビュータブには、Workshop のウィジェットサンドボックス内でウィジェットが表示されるため、埋め込み後とまったく同じ見た目を確認できます。エディタービューでは、デフォルトでローカルに生成されたシードデータがプレビューに使われます。実際のオントロジーデータでプレビューするには、シードデータ / 本番データの切り替えを使って本番データに切り替えます。

ウィジェットのパラメーターやイベントを変更した場合は、ウィジェットのプレビューでウィジェット開発モードを再読み込みを選択すると、実行中のプレビューに変更が適用されます。

オントロジーを操作する

ウィジェットは、Workshop で閲覧しているユーザーの権限を使い、オントロジー SDKを通じてオントロジーの読み取りと書き込みを行います。オントロジータブでは、既存のエンティティを参照したり、変更が許可されている場合は Pilot に新しいエンティティを提案させたりできます。Pilot に許可する変更は、オントロジータブから制御できます。

作成中にモデルが実際のデータにアクセスすることはありません。本番データでプレビューする場合でも、データはモデルに公開されません。詳細については、シードデータとライブデータを参照してください。

次のステップ

• カスタムウィジェットをデプロイする：ウィジェットを Widget Registry に公開し、Workshop アプリケーションに埋め込みます。
• アプリケーションを作成する：独立したホスト型アプリケーションを作成します。