AI エージェントの管理

早期アクセス

エージェントページ

AI エージェントを管理するには、AI エージェント > マイエージェント に移動します。

このページでは、次のことができます。

検索ボックスを使用して、エージェントを名前で検索します。
テーブルヘッダーを使用してエージェントを並べ替えます。
[エージェントのインポートを選択して、**インポート**エージェントを作成します。
エージェントの作成を選択して、**作成**新しいエージェントを作成します。

リスト内の各エージェントについて、このページには、エージェント名、説明、接続されているサブエージェントの数 (オーケストレーターのみ)、および最終変更日が表示されます。

エージェントごとに、メニュー (3 つのドット) を選択して、次のアクションにアクセスします。

編集 - エージェント構成を更新します。
品質センターに移動 - AI エージェントの出力をテストして、期待どおりかどうかを確認します。
Duplicate - エージェントのコピーを作成します。
エクスポート - エージェント構成をエクスポートします。
削除 - エージェントを削除します。

AI エージェントの編集

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントのメニュー (3 つのドット) を選択します。
Edit (編集) を選択します。
ユースケースと要件を満たすように AI エージェントを更新します。

品質センターに移動

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントのメニュー (3 つのドット) を選択します。
品質センターに移動 を選択します。
AI エージェントのテストに進みます。

AI エージェントの複製

AIエージェントは、[エージェント]ページまたはエージェント内から複製できます。

[エージェント] ページからの複製

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントのメニュー (3 つのドット) を選択します。
Duplicate (複製) を選択します。
ユースケースと要件を満たすように AI エージェントを更新します。

AI エージェント内からの複製

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントを開きます。
メニュー (3 つのドット) で、複製を選択します。
ユースケースと要件を満たすように AI エージェントを更新します。

AI エージェントのエクスポート

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントのメニュー (3 つのドット) を選択します。
Export (エクスポート) を選択します。

エージェント構成は.exportファイルとしてダウンロードされます。

AI エージェントのインポート

以前に.export形式でエクスポートされたファイルをインポートできます。

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
エージェントのインポートを選択します。
.export ファイルを参照し、[インポート] を選択します。

AI エージェントが マイエージェント ページに表示されます。

AI エージェントを削除する

大事な

AI エージェントの削除は永続的であり、元に戻すことはできません。

AI エージェントは、[マイエージェント] ページまたはエージェント内から削除できます。

[エージェント] ページからの削除

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントのメニュー (3 つのドット) を選択します。
Delete (削除) を選択します。

AI エージェント内から削除する

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントを開きます。
メニュー (3 つのドット) で、削除を選択します。

エージェントマニフェストの表示

マニフェストには、AI エージェントの完全な構成が JSON または YAML 形式で表示されます。

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
必要な AI エージェントを開きます。
メニュー (3 つのドット) で、[コードとして表示] を選択します。

エージェントマニフェストの詳細については、「エージェントマニフェスト](/agentos-ai-agents/advanced-topics/agent-manifests)を参照してください。

バージョン履歴

エージェントはバージョン管理をサポートしているため、構成のスナップショットを作成し、本番用に特定のバージョンをアクティブ化し、必要に応じてロールバックできます。

手記

ナレッジエージェントはバージョン管理をサポートしません。

バージョンの状態

各エージェントには、構成から運用環境への使用までの進行状況を追跡するライフサイクルがあります。エージェントは、次のいずれかの状態になります。

州	説明
ドラフト	変更可能な進行中の作業バージョン。自由に編集できます。エージェントごとに一度に 1 つのドラフトのみが存在します。
保存済みバージョン	ドラフトから作成された不変のスナップショット。保存したバージョンは編集できません。エージェントごとに複数の保存済みバージョンが存在する可能性があります。
アクティブバージョン	本番環境用にデプロイされる保存済みバージョン。エージェントごとに一度にアクティブにできるバージョンは 1 つだけです。チャットボットまたは統合がエージェントを呼び出すと、アクティブなバージョンがリクエストを処理します。

オーケストレーターエージェントがサブエージェントを参照する場合、オーケストレーターをアクティブ化すると、正確なサブエージェントバージョンが不変のスナップショットに固定されます。

詳細については、「サブエージェントのバージョン管理](/agentos-ai-agents/advanced-topics/orchestration#subagent-versioning)」を参照してください。

バージョン履歴へのアクセス

NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
エージェントを開きます。
バージョン を選択します。

右側にバージョン履歴パネルが開きます。エージェントのすべてのバージョンが表示され、現在 (ドラフト) が常に上部に表示されます。

バージョンを作成する

バージョンを作成すると、現在のドラフトのスナップショットが保存されます。

エージェントを開き、バージョン履歴 を選択します。
バージョンの作成 を選択します。
バージョン番号 (V1、V2 など) が自動的に割り当てられます。
必要に応じて、バージョン名 と説明を入力します。
Create (作成) を選択します。

バージョンがバージョン履歴リストに表示されます。

バージョンをアクティブ化する

バージョンをアクティブ化すると、運用環境用にデプロイされます。エージェントごとに一度にアクティブにできるバージョンは 1 つだけです。すでにアクティブなバージョンがある場合は、新しくアクティブ化されたバージョンに置き換えられます。

バージョンをアクティブ化する前に、まず作成 (保存) する必要があります。

エージェントエディタからアクティブ化:

エージェントを開き、[アクティブ化] を選択します。
バージョン番号が自動的に割り当てられます。
必要に応じて、バージョン名 と説明を入力します。
アクティブ化を選択します。

バージョンが保存され、アクティブなバージョンとして設定されます。エージェントのステータスが [マイエージェント] ページで アクティブ に変わります。

バージョン履歴からアクティブ化:

エージェントを開き、バージョン履歴 を選択します。
アクティベートするバージョンを選択します。
アクティブ化を選択します。