さまざまなツールを設定して、外部サービス統合、コード実行、ナレッジ取得を通じてエージェントの機能を拡張します。
ツールの概要
LangStudio は、さまざまな形式の外部機能を統合するために、5 種類のツールを提供しています:
-
MCP ツール: MCP プロトコルに準拠したバックエンドサービスをプラットフォームに登録し、エージェントが必要に応じて呼び出すことで、安全な外部システムとの対話を可能にします。
-
カスタムツール (OpenAPI ツール): OpenAPI 3.0+ 仕様ファイルを提供すると、プラットフォームが自動的に呼び出し可能なツールに変換します。API エンドポイントごとに 1 つのツールが生成されます。
-
Python ツール: Python 関数を記述すると、プラットフォームが自動的に関数シグネチャ、型アノテーション、ドキュメントを抽出し、エージェントが呼び出すための構造化された説明を生成します。
-
ナレッジベースツール: 既存のエンタープライズナレッジベースをエージェントノードに直接設定し、推論中にオンデマンドで非公開ナレッジを取得できるようにします。
-
Web 検索ツール: インターネット検索エンジンを介してリアルタイム情報を取得します。エージェントはこのツールを自動的に呼び出して、最新のニュース、事実データ、その他の Web コンテンツをクエリします。
ユースケースに基づいて適切なツールタイプを選択します:
|
ツールタイプ |
ユースケース |
主な特徴 |
|
MCP ツール |
内部マイクロサービス、プライベート API |
低コストな統合、組み込みの可観測性 |
|
カスタムツール |
サードパーティ SaaS、RESTful サービス |
ゼロコード統合 |
|
Python ツール |
複雑なロジック処理、ローカル計算 |
柔軟なプログラミング、Python エコシステムとの緊密な統合 |
|
ナレッジベースツール |
独自ナレッジの Q&A |
すぐに利用可能、エージェントによる自動取得 |
|
Web 検索ツール |
リアルタイムな情報クエリ、最新ニュース |
Web の自動取得 |
ツールの組み合わせと選択ガイドライン:
-
1 つのエージェントに複数のツールを設定できます。例えば、MCP ツール (内部 API 呼び出し) と Python ツール (データ処理) を組み合わせて、複雑なビジネスロジックを処理します。
-
内部 API がまだ MCP プロトコルを実装していないが OpenAPI 仕様がある場合は、まずカスタムツールを使用して迅速に統合し、後で可観測性を向上させるために MCP ツールに移行します。
MCP ツールの設定
MCP ツール接続の作成
-
LangStudio に移動し、 に移動して、Create Tool をクリックします。
-
作成方法を選択します:
-
FunctionAI: で作成された MCP サービスを設定します。
-
デプロイ済みの MCP サービスを選択すると、システムが自動的に接続パラメーターを入力します。
-
-
カスタム: 自身でデプロイした、またはサードパーティのプラットフォームでホストされている MCP サービスを設定します。
-
transport: MCP サービスと通信するための基盤となるトランスポートプロトコルです。SSE と StreamableHTTP をサポートしています。
-
url: MCP サービスの完全なアクセスエンドポイント URL です。
-
authentication: MCP サービスにアクセスするための認証情報を設定します。以下の 3 種類をサポートしています:
-
BearerAuth: Bearer トークン認証を使用します。[token] フィールドに有効なアクセストークンを入力します。
-
Other: auth_header_name と token を入力して、どのリクエストヘッダーがトークンを提供するかを指定します。
-
None: 認証は不要です。
-
-
-
-
(任意) 接続性テストを実行して、MCP サービスにアクセスできることを確認します。
-
[送信] をクリックしてツールを作成します。
エージェントノードの設定
エージェントノードの設定ページで、MCP Tool を見つけます。2 つの設定方法がサポートされています:
-
既存の MCP ツール接続を選択: まず、再利用可能な MCP ツール接続を作成します。詳細については、「MCP ツール接続の作成」をご参照ください。MCP サービスは通常、複数のツールを提供します。ツールの範囲を設定し、特定のツールに対して承認を要求することができます。
-
ツール範囲オプションを使用して、モデルから見えるツールを制御します。
-
機密性の高い操作 (ユーザーデータの変更など) を行うツールについては、保護のために Approval tools 機能を有効にします。ワークフローがこれらのツールに到達すると、ノードは自動的に一時停止し、手動での確認を待ちます。ワークフローは承認後にのみ続行されます。
-
-
カスタム MCP 設定: このノード内でのみ利用可能です。

その他のツールタイプの設定
エージェントノードの設定ページで、Tools に移動してさまざまなツールを追加します。選択したツールについては、ツールの説明、「Needs Approval」、およびその他のパラメーターを編集できます。
-
ナレッジベース: エージェントに追加する前に、「ナレッジベースの管理」を参照してナレッジベースを作成します。
-
カスタムツール (OpenAPI ツール):
-
既存のカスタムツールを選択するか、Create Custom Tool をクリックします。
-
PAI-EAS にデプロイ済みの LangStudio サービスからツールを作成するか、手動で OpenAPI 仕様を入力します。
-
ツールの作成後、ツールの詳細ページに移動し、[テスト] 機能を使用してサンプルリクエストを送信し、応答を検証します。
-
-
Python ツール:
-
既存のツールを選択するか、Create Python Tool をクリックします。
-
新しいツールを作成する場合は、ツールセット名を設定し、開いたページでコードを編集してテストします。
-
既存の Python ツールの表示または編集: アプリケーション開発ページの右上隅にある をクリックします。ファイルは、アプリケーションのソースディレクトリ配下の
toolsフォルダにあります。
-
-
Web 検索ツール: Alibaba Cloud IQS-Standard Search を使用します。ツールを追加した後、設定については「IQS-GenericSearch」をご参照ください。