ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

エージェント

エージェントビルダーは、AI Hubアカウントで利用可能なエージェントを管理する場所です。組み込みのエージェントと、作成したカスタムエージェントが一覧表示されます。組み込みのエージェントは、トーンの変更、スペルと文法の修正、文章の改善、Liferay検索、文章を長くする、文章を短くする、です。この画面から、新しいエージェントを作成したり、既存のエージェントを編集・複製したり、不要になったエージェントを削除したり、エージェントを操作できるユーザーを制御する権限を設定したりできます。

AI Hub UIの左側のナビゲーションからエージェントビルダーを開きます。エージェントはアカウントごとに設定されるため、このリストにはあなたのアカウントのエージェントが表示され、他のアカウントのエージェントは表示されません。

既存の翻訳エージェントからカスタム翻訳エージェントを構築する手順については、カスタムエージェントの構築を参照してください。

エージェントリストの表示

AI Hub の左側のナビゲーションで Agent Builder をクリックしてリストを開きます。「エージェント」タブには、アカウントに登録されているすべてのエージェント（組み込みエージェントとカスタムエージェント）が表示されます。

エージェントビルダーの「エージェント」タブには、各エージェントの説明とアクションメニューが表示され、その下にフィルターコントロール、検索ボックス、および新規エージェントボタンがあります。

各エージェントはアクティブまたは非アクティブの状態であり、ステータスでリストをフィルタリングできます。各行には、エージェントの種類に応じてオプションが異なる「アクション」メニューがあります。

Liferayに組み込まれている管理エージェントは読み取り専用です。彼らの「アクション」メニューには、「表示」と「複製」しか表示されません。
カスタムエージェントは、表示、複製、有効化または無効化、削除、および権限設定といったすべての機能をサポートします。

エージェントの作成または複製

注

Activateサブスクリプションティアでは、エージェントの作成に制限があります。

既存のエージェントを複製し、カスタマイズする必要があります。
最大5つのカスタムエージェントを作成できます。

カスタムエージェントを作成するには、新規または複製した定義から始め、エージェントフォームに必要事項を入力します。

新しいエージェント をクリックして、空の定義から開始します。

または、既存のエージェントを複製します。そのアクションメニューから複製をクリックします。これはエージェントの定義を新しいエージェントにコピーするため、すべてを最初から設定するのではなく、変更を加えるための作業開始点が得られます。
エージェントを定義する。まずはタイトルと説明文を入力してください。
エージェントのロジックを構築するには、 ワークフローの表示 をクリックしてください。
エージェントの入力と出力を、 入力変数 (カンマ区切りのリスト) と 出力変数 に指定します。例えば、 という名前の入力フィールドにというテキストを入力します。作成したワークフローはこれらの名前を参照します。
あらかじめ入力されている 外部参照コード をそのまま使用するか、独自のコードを設定してください。これは、エージェントを外部システムに識別するためのものです。
エージェントを有効にするには、 エージェントを有効にする トグルを使用します。
オプションで、データソースを 割り当て済みソース フィールドに追加し、ガードレールを割り当てます。

エージェント作成フォームには、詳細、ワークフロー、変数、データソース、およびガードレールの各セクションがあります。

エージェントのワークフローロジックの編集を含む完全な手順については、カスタムエージェントの構築を参照してください。

エージェントの編集

組み込みエージェントは読み取り専用なので、編集できるのはカスタムエージェントのみです。カスタムエージェントを開いて、詳細とロジックを変更します。

エージェントのアクションメニューから、 ビュー をクリックします。
エージェントの タイトル と説明を編集します。
［Save（保存）］をクリックします。
エージェントのロジックを変更するには、 ワークフローの表示 をクリックし、ワークフローノードを編集します。
をクリックして を更新し、ワークフローの変更を保存します。

エージェントの有効化、無効化、および削除

これらの操作はカスタムエージェントにのみ適用され、組み込みエージェントは無効化または削除できません。カスタムエージェントのアクションメニューを使用して、そのライフサイクルを管理します。

をクリックして を有効化し、非アクティブなエージェントを再び有効にします。
をクリックして を無効化すると、アクティブなエージェントの定義を保持したままサービスから除外できます。
エージェントを完全に削除するには、 をクリックして を削除してください。

エージェント権限の設定

エージェントアクセスには2つのレイヤーがあります。

アカウントロール は、すべてのエージェントに対して権限を付与します。 AI Hubエージェント管理者などの組み込みロールを割り当てれば、そのロールを持つユーザーはすべてのエージェントを操作できるため、各エージェントへのアクセス権を個別に付与する必要はありません。

エージェントはアカウントに紐づけられているため、アカウントロールと通常ロールの両方を通じてアクセス権を付与できます。サイトロールは適用されません。
エージェントごとの権限 は単一のカスタムエージェントに適用され、ユーザーのアカウントロールで既に許可されている権限を拡張するのではなく、制限することができます。例えば、アカウントの役割によってすべてのエージェントに対する更新アクセス権限が付与されている場合、エージェントごとの設定によって特定の機密性の高いエージェントに対する更新アクセス権限を削除することはできますが、既に更新アクセス権限が付与されていないユーザーに更新アクセス権限を付与することはできません。

エージェントごとの権限設定は、カスタムエージェントでのみ利用可能です。各カスタムエージェントには専用の権限モーダルがあり、ページ、フラグメント、その他のDXPエンティティで使用されるものと同じ、標準のLiferay権限コンポーネントを使用します。それを開くには、エージェントのアクションメニューので権限をクリックします。モーダルウィンドウには、各役割が一覧表示され、付与できる権限（表示、更新、削除、権限、オブジェクトエントリ履歴）のチェックボックスが表示されます。権限を持つユーザーのみがモーダルを開くことができ、変更は保存するとすぐに反映されます。