AI エージェントの作成と構成
早期アクセスAI エージェントは、最初から作成することも、以前にエクスポートしたエージェント構成を インポート することもできます。
AI エージェントを作成するには、次のいずれかのオプションを選択します。
新しい AI エージェントを作成する
新しい AI エージェントを作成するには:
- NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
- エージェントの作成 を選択します。
- 設定 以下で説明するようにフィールドに追加します。
AI エージェントのインポート
AI エージェントをインポートするには:
- NTT CPaaS Webインターフェイスで、AIエージェント>マイエージェントに移動します。
- エージェントのインポートを選択します。
.exportファイルを参照します。- インポートを選択して確認します。
エージェントを構成する
エージェントの ID、動作、統合、およびモデル設定を定義するエージェント プロパティを構成します。
| フィールド | 説明 |
|---|---|
| 名前 | ワークスペース内のエージェントを一意に識別します。名前を変更するには、現在の名前の横にある鉛筆アイコンを選択します。 |
| 説明 | (必須) エージェントの目的と責任を説明する簡単な説明。他のエージェントはこれを使用して、このエージェントをいつ、どのように呼び出すかを理解します。 |
| 手順 | エージェントの通信方法、タスクの実行方法、エンドユーザーとの対話方法など、エージェントの動作仕様を定義します。基盤となる言語モデルのシステムプロンプトとして機能します。エディターは、推奨セクションを含む構造化されたテンプレートを提供します。 |
信頼できる AI エージェントには効果的なプロンプトが不可欠です。ロール定義、手順、ツールの使用法、および完全な例に関するベストプラクティスについては、AIエージェントのプロンプトの作成を参照してください。
定義済みのテンプレートを使用して、手順を入力できます。
- 予約エージェント
- 注文ステータスアシスタント
- 営業担当者
完全なプロンプトの例については、「AI エージェントのプロンプトの作成](/agentos-ai-agents/advanced-topics/write-prompts#complete-example-finance-tracker-agent)を参照してください。
ツール
ツールは、AIエージェントがアクションを実行し、外部システムと統合できるようにすることで、AIエージェントの機能を拡張します。
たとえば、ツールを使用すると、エージェントは次のことができます。
- API の呼び出し
- バックエンドロジックの実行
- 外部データの取得
- 自動化されたワークフローをトリガーする
ツールセクションで:
- [ツールの追加] を選択します。
- ツールの種類を選択します。
- コンポーネント
- MCP サーバー
- Exchange アプリケーション
- ツールを削除するには、その横にある X アイコンを選択します。
コンポーネント
コンポーネントは再利用可能なロジックをカプセル化し、複数の API 呼び出しまたはバックエンド プロセスを調整できます。エージェントが複雑なワークフローまたはバックエンド統合を実行する必要がある場合にコンポーネントを使用します。
ベストプラクティスは、AIエージェントでチャットボットコンポーネントを使用するを参照してください。
AI エージェントでは、チャネルに依存しないコンポーネントのみを使用できます。チャネルに依存しないコンポーネントは、すべての通信チャネルで機能します。
コンポーネントを追加するには:
- コンポーネントの作成を選択して新しいコンポーネントを作成するか(コンポーネントドキュメントに従ってください)、リストから1つ以上の既存のコンポーネントを選択します。
- コンポーネントの追加 を選択します。
ドラフトコンポーネントを選択した場合は、AIエージェントをアクティブ化する前に公開します。
MCP サーバー
次のフィールドを設定します。
| フィールド | 説明 |
|---|---|
| 名前 | MCP サーバーを識別するための一意の名前。 |
| URL | AI エージェントがリクエストを送信するエンドポイント URL。 |
| ヘッダー | HTTP ヘッダーをキーと値のペアとして使用します (認証トークンなど)。 |
| 許可される機能 | 呼び出されたときにサーバーが実行できるアクション。 |
追加後にMCPサーバーを編集するには、MCPサーバーを選択して詳細を更新します。
ユースケースと詳細については、MCPサーバーを参照してください。
Exchange アプリケーション
- リストから 1 つ以上の統合を選択します。
- Add (追加) を選択します。
サブエージェント
このエージェントは、他の AI エージェントを調整するオーケストレーターとして構成できます。Orchestrator エージェントは、次のことができます。
- 専門エージェントにタスクを委任する
- 回答を組み合わせる
- 会話のルーティングを制御する
サブエージェントの追加
サブエージェントを追加するには:
- エージェントの追加 を選択します。
- リストから 1 つ以上の AI エージェントを選択します。
- エージェントの追加 を選択します。または、エージェントの作成 を選択します。
オーケストレーションの詳細については、「オーケストレーション](/agentos-ai-agents/advanced-topics/orchestration)」を参照してください。
詳細設定(オプション)
| フィールド | 説明 |
|---|---|
| モデル | 推論機能、レイテンシ、コストの要件に最も適した LLM モデルを選択します。 |
| ガードレール | コンテンツフィルターを選択して、エージェントの会話で有害なコンテンツを検出してブロックします。設定の詳細は、ガードレールの設定(/agentos-ai-agents/ai-agents/configure-guardrails)を参照してください。 |
| エージェント構造化出力 | 特定の応答形式を適用する JSON スキーマを定義します。ユースケースと詳細については、「構造化出力](/agentos-ai-agents/advanced-topics/structured-output)を参照してください。 |
エージェントの保存とバージョン管理
エージェントを設定すると、変更は現在のドラフトに自動保存されます。システムは、最大 10 個の自動保存バージョン を保持します。
名前付きスナップショットを保存する準備ができたら、次のようにします。
- [バージョン] > [バージョンの作成] を選択します。
- バージョン番号 (V1、V2 など) が自動的に割り当てられます。
- オプションで、バージョン名と説明を追加できます。
本番環境で使用するバージョンをデプロイするには:
- アクティブ化を選択します。
- バージョンをアクティブ化すると、そのバージョンがエージェントのアクティブ バージョンとして設定されます。
バージョン管理の詳細については、バージョン履歴を参照してください。
メニュー アイコン (3 つのドット) を選択して、次のオプションにアクセスします。
- コードとして表示: エージェント構成をコードとして表示します。
- セッション履歴に移動: 以前のセッションと関連する分析を表示します。