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

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

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

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

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

Pilot が生成するもの

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

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

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

ウィジェットは制限付きのサンドボックスで実行されます。Pilot に指示を出すときは、次の点に注意してください。

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

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

プレビュータブでは、Workshop のウィジェットサンドボックス内にウィジェットが表示されるため、埋め込み時と同じサンドボックスでテストできます。ウィジェットのサイズとパラメーターは Workshop のレイアウトによって決まります。［エディタービュー］では、プレビューはデフォルトでローカルに生成されたシードデータを使用します。実際のオントロジーデータでプレビューするには、仮想データ / 本番データの切り替えを使用して、本番データに切り替えます。

ウィジェットを設定を選択して代表的なパラメーター値を入力し、プレビューへの影響を確認します。

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

オントロジーを操作する

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

本番データをプレビューするだけでは、アプリケーションを作成しているエージェントにそのレコードが共有されることはありません。有効になっている場合は、別の本番データ閲覧用エージェントが実際のデータを分析でき、その分析を共有する前にレビューのステップがあります。本番データのプレビューで行う操作は、実際のレコードを変更する可能性があります。詳細については、データを操作するを参照してください。

ウィジェット環境では、これらの設定とは独立してオントロジーの変更を制限できます。これらのスキーマ編集権限は、実際のレコードへのアクセスを付与するものではありません。

次のステップ

• カスタムウィジェットをデプロイする：ウィジェットを Widget Registry に公開し、Workshop アプリケーションに埋め込みます。
• アプリケーションを作成する：単独でホストされるアプリケーションを作成します。
• ブランチ、変更、提案：リリース前にウィジェットのコードをレビューします。