すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:エージェントアプリケーション

最終更新日:Apr 30, 2025

Model Studio コンソールで、コードを書かずにエージェントアプリケーションをすばやく作成し、RAG(Retrieval-Augmented Generation)とプラグイン機能を統合できます。 アプリケーションを作成したら、コンソールまたは API を介して使用できます。

エージェントアプリケーションを使用する理由

大規模言語モデル(LLM)は強力な言語理解と生成機能を備えていますが、次のような制限もあります。

  • 会社のポリシーや人事情報など、プライベートドメインの質問に回答できません。

  • リアルタイムの天気やスポーツのスコアなど、リアルタイム情報にアクセスできません。

  • 複雑な数学的計算や画像生成など、専門的な質問に対して正確な回答を提供できません。

エージェントアプリケーションは、カスタマイズされた外部機能と統合された LLM を活用することで、これらの課題を克服します。

外部機能とは、リアルタイムデータのクエリやプライベートドメインの質問への回答など、LLM に固有ではない機能を指します。

コーディングなしで Model Studio コンソールを使用してエージェントアプリケーションをすばやく作成し、ビジネスニーズに対応する外部機能を組み込むことができます。

エージェントアプリケーションの典型的なシナリオは次のとおりです。

  • プライベートドメインナレッジ Q&A

    ナレッジベースファイルを準備し、コンソールでプライベートドメイン Q&A アプリケーションをすばやく作成します。 アプリケーションは、会社のポリシー、従業員情報などに関するクエリに適しています。

  • インテリジェントアシスタント

    RAGおよびカスタムプラグインを組み込んで、メール管理やレポート作成などのタスクの作業効率を高めるインテリジェントアシスタントを構築します。

ステップ 1:エージェントアプリケーションを作成する

1. アプリケーションを作成する

マイアプリケーション に移動し、[アプリケーションの作成] をクリックします。 [エージェントアプリケーション] タブで、[今すぐ作成] をクリックします。

すでにアプリケーションがある場合は、右上隅にある [アプリケーションの作成] をクリックします。

image

2. モデルを選択してパラメータを構成する

構成ページで、モデルを選択し、パラメータを構成します。 [設定] をクリックし、[モデルの選択] ボックスからモデルを選択します。 ここでは、[Qwen-Max] を選択します。

パラメータを構成します。 詳細については、image アイコンにカーソルを合わせます。 特定のニーズがない場合は、デフォルト設定を使用します。

image

3. アプリケーションをテストする

モデルを選択すると、エージェントアプリケーションを使用できるようになります。 質問を入力してテストします。

image

ステップ 2:アプリケーションの機能を拡張する

アプリケーション構成ページで、プロンプト、RAG、およびプラグインを追加して、アプリケーションの機能を拡張します。

システムプロンプト:生成の方向性をガイドする

応答の方向性をガイドするプロンプトを入力します。 たとえば、次のプロンプトを入力します。

/* ウィリアム・シェイクスピアの口調を真似してください。 */
Please imitate the tone of William Shakespeare.

「こんにちは」と入力すると、アプリケーションは次の応答を返します。

image

image

RAG:プライベートドメインナレッジを導入する

Retrieval-augmented generation(RAG)は、関連するドキュメントコンテンツを自動的に取得し、この情報をエージェントのコンテキスト入力として使用することで、エージェントの応答の精度を向上させる取得手法です。 プライベートナレッジまたはドメイン固有の Q&A の場合、RAG はエージェントのパフォーマンスを大幅に向上させることができます。

注:RAG によって取得されたテキストは、モデルのコンテキストウィンドウの長さを占めます。 そのため、取得戦略とテキストの長さを調整して、コンテキストウィンドウを最大限に活用し、制限を超えないようにする必要があります。

1. データをアップロードする

アプリケーションデータ に移動し、[データのインポート] をクリックします。 この場合、Bailian Phones Specifications.docx がサンプルファイルとして使用されます。 [データのインポート] ページで、[ローカルファイルのアップロード] を選択します。

image

2. ナレッジベースを作成する

  1. ナレッジベース に移動し、[ナレッジベースの作成] をクリックします。 [ナレッジベースの作成] インターフェースで、[名前][説明] を入力します。 ここでは、名前を 製品紹介 に設定し、説明を このナレッジベースには、Bailian 電話製品の詳細情報が含まれています に設定します。 その他のオプションはデフォルトのままにして、[次のステップ] をクリックします。

  2. [ファイルの選択] を選択し、[デフォルトカテゴリ] を選択します。 次に、[Bailian Phones Specifications] を選択し、[次のステップ] をクリックします。

  3. データ処理には、デフォルトの インテリジェント分割 を使用し、[インポート] をクリックします。

  4. ステータスが [解析完了] と表示されたら、ナレッジベースが作成されたことを意味します。

image

image

image

3. アプリケーションに RAG を統合する

  1. マイアプリケーション に移動し、作成したアプリケーションカードの [管理] をクリックします。 [ナレッジベース] をオンにすると、[プロンプト] に対応する指示が自動的に入力されます。 [+ ナレッジベース] をクリックし、リストから [電話紹介] を選択します。 その他のオプションはデフォルトのままにします。

  2. [取得構成](オプション):

    アセンブリ戦略を構成したり、ナレッジスコープを設定したり、回答ソースを表示したりする必要がある場合は、構成をさらに変更できます。 詳細については、「ステップ 4:ナレッジベースを使用する」をご参照ください。

  3. [サンプルライブラリ](オプション):

    有効にすると、${samples} 変数がプロンプトに追加され、少数のプロンプト例が導入されて生成結果が向上します。

    • [サンプルライブラリ]:サンプルを追加します。

    • [構成]:取得するチャンク数を設定します。

  4. 入力ボックスに質問を入力します。

    ゲームが好きなのですが、どの電話がお勧めですか?

    アプリケーションは、提供されたドキュメントに基づいて質問に答えることができるようになりました。

    現在、エージェントアプリケーションはテキストコンテンツのみを生成できます。

image

image

プラグイン:より効率的なツール

プラグインは、ビジネスシナリオにおけるエージェントアプリケーションの効率と専門的能力を向上させることができます。 アプリケーションの構成ページで、[+ プラグイン] をクリックして、[プラグインの選択] パネルで 1 つ以上のプラグインを選択できます。

カスタムプラグインを追加することもできます。 詳細については、「プラグインの概要」をご参照ください。

1. プラグインを追加する

画像生成 プラグインを例に、コンポーネントギャラリー で見つけて、[エージェントに追加] をクリックします。

image

2. プラグインをテストする

プラグインを追加したら、入力ボックスに次のように入力します。

猫を描いてください

エージェントアプリケーションは、画像生成プラグイン(text_to_image)を呼び出します。

image

3. 他のプラグインを使用する

同じエージェントアプリケーションで最大 10 個のプラグインを選択できます。 エージェントアプリケーションは、入力に基づいて 1 つ以上のプラグインを使用することを選択します。 たとえば、次のように質問します。

明日の杭州の天気を確認し、この天気で西湖を描いてください。

エージェントアプリケーションは、右の画像に示すようにコンテンツを出力します。

image

ステップ 3:アプリケーションを体験する

現在、エージェントアプリケーションは、テキストのみで体験できます。

ステップ 4:エージェントアプリケーションを公開する

アプリケーションを公開して、同じメインアカウントの RAM ユーザーが API またはウェブページからアクセスできるようにします。 構成ページの右上隅にある [公開] をクリックします。

アプリケーションが以前に公開されている場合は、ダイアログボックスが表示され、最後のバージョン以降の変更が表示されます。 これらの変更を確認し、[公開の確認] をクリックします。

説明

RAM ユーザーとしてアプリケーションを作成した場合は、アプリケーションを公開する前に ram:CreateServiceLinkedRole 権限を持っていることを確認してください。 詳細については、「サービスにリンクされたロール」をご参照ください。

image

アプリケーションを初めて公開するときは、ダイアログボックスは表示されません。

API を使用する

[公開チャネル] タブの [API 呼び出し] の右側にある [API の表示] をクリックして、API リファレンスを参照します。

注:呼び出しを開始するには、YOUR_API_KEY を API KEY に置き換える必要があります。

image

[公式共有方法] を使用する

公式共有方法の右側にある [共有リンクの生成] をクリックします。 このリンクを同じ Alibaba Cloud アカウントの RAM ユーザーと共有できます。

image

ステップ 5:アプリケーションの名前変更、コピー、削除

[マイアプリケーション] でアプリケーションカードを見つけます。 [その他] > [アプリケーションの名前変更/コピー/削除] を選択します。

image

ステップ 7:バージョン管理

次の手順を実行して、履歴バージョンの説明を編集するか、公開済みの履歴バージョンに切り替えます。

  1. [アプリケーション構成] タブで、上部ナビゲーションバーの右側にある [バージョン管理] をクリックします。image

  2. 履歴バージョンリストでバージョンを選択します。image

    • バージョンの説明を編集する必要がある場合は、image アイコンにカーソルを合わせてクリックします。 [バージョンの説明の編集] ダイアログボックスで、必要な変更を加えて、[OK] をクリックします。

    • このバージョンを使用する必要がある場合は、[現在のドラフトを上書き] をクリックし、ダイアログボックスで [確認] をクリックします。

      確認すると、選択したバージョンが現在のドラフトバージョンを上書きします。

FAQ

  • ナレッジベースの取得には追加料金がかかりますか?

    機能自体は無料で使用できます。 ただし、リコールされたコンテンツはモデル入力として使用され、入力トークンの価格に基づいて課金されます。

  • カスタムプラグインにはタイムアウト制限がありますか?

    はい、タイムアウト制限は 5 秒です。

  • API を使用してエージェントアプリケーションを作成できますか?

    アシスタント API を使用して、エージェントアプリケーションと同様の機能を持つ LLM アプリケーションを作成できます。

    注: コンソールでアシスタント API によって作成されたアプリケーションを管理することはできません。 詳細については、「アシスタント API」をご参照ください。