AIエージェントは、アクセスできるデータほど強力ではない。大規模言語モデルLLMs）は学習データから応答を生成するが、APIと統合されていない限り、リアルタイムの株価を取得したり、支払いを処理したり、CRMの詳細にアクセスしたりすることはできない。
APIは、AIエージェントがリアルタイムのデータにアクセスし、ロジックを実行し、アクションをトリガーすることを可能にする。APIを完全に活用するには、エージェントはカスタムコードを必要とする。
Botpress Studioの'コード実行'カードは、ボットのワークフロー内でJavaScriptを記述して実行することができ、APIコール、データ処理、ボット動作のカスタマイズをシームレスに処理します。
エグゼキュート・コード・カードとは何ですか？
Botpress コード実行カードは、ボットのフロー内でカスタムJavaScriptを実行することができます。以下のような機能があります：
- カスタムロジックの実装：複雑な計算を実行したり、標準のアクションではカバーできない方法でデータを変換することができます。
- ダイナミックなインタラクション：ユーザーデータやリアルタイムの計算に基づいてレスポンスを調整。
- データ統合：サードパーティのサービスとシームレスに接続し、データを取得または送信します。
- 状態管理： ボットのステートにアクセスし変更することで、コンテキストを維持し、インタラクションをパーソナライズします。
- エラー処理：堅牢な運用を保証するために、カスタムエラー管理を実装します。
コード実行カードは AIがコードを提案します。APIデータの取得のようなプロンプトを入力すると、システムが即座にJavaScriptを生成します。その後、必要に応じてレビュー、編集、改良を行うことができ、開発をスピードアップします。
なぜAIエージェントは外部APIを必要とするのか？
AIエージェントは、彼らがアクセスするデータやサービスと同じ程度にしか役に立たない。AIエージェントは入力を処理し、応答を生成することはできるが、リアルタイムの知識、トランザクション機能、外部APIなしの深い統合には欠けている。
リアルタイムデータの統合、ワークフローの自動化、セキュリティの強化など、APIはボットをよりインテリジェントにし、応答性を高め、統合します。
エグゼキュート・コード・カードの5つの使い方
Botpress Studioのコード実行カードは、AIエージェントの操作を効率化します。ワークフローへの追加は簡単です：
追加されたら、Agenticワークフローで活用する主な方法を紹介します。
1.ダイナミックAPIコール
静的なAPIコールを使用する代わりに、Execute Cardを使用すると、ユーザーの意図、ボットのコンテキスト、または以前の会話に基づいて動的にリクエストを変更することができます。
例ユーザー設定に基づくカスタムデータの取得。
プロンプト旅行チャットボットは、ユーザーの目的地、旅行日、予算に基づいてホテルの価格を取得する必要があります。
.webp)
注意 Execute Code Cardは自然言語からコードを生成することができます。ただし、常に 変数 を検証してください。
2.LLM 回答の後処理
Botpress 組み込みのAIアクションが用意されていますが、ユーザーに表示する前に、出力をフォーマットしたり、特定の単語をフィルタリングしたり、データをより明確に構造化するなど、レスポンスを微調整する必要がある場合もあります。
例：非構造化LLM 応答を定義されたテーブル/フォーマットに書き換える。
プロンプト：AIがAPIからお勧めのレストランを取得するので、表示する前にきれいな表に整形してほしい。
.webp)
3.速度制限と条件付き実行
デジタルウォレットを含むいくつかのAPIには利用制限があります。Execute Code Card を使えば、レート制限の適用、フォールバックの設定、API の可用性に基づいた条件ロジックの追加によって、ユーザーとのやりとりをコントロールできます。
例：呼び出す前にAPIの使用法をチェックする
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4.パーミッションの取り扱い
ボットが特定の機能へのアクセスを許可する前にユーザーを確認する必要がある場合、カードはBotpressデフォルトオプションを超えるカスタム認証フローを可能にします。
例：AI応答を提供する前にユーザーの購読ステータスをチェックする
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5.マルチステップAPIチェーニング
ボットが最終的なレスポンスを送信する前に、複数のAPIからデータを組み合わせる必要があることがあります。このカードは、動的にデータを取得、変換、渡すことで、複雑なマルチステップワークフローを可能にします。
例：天気予報＋レストラン予約で、最適な出発時間を提案
プロンプト：workflow.userApiKeyを使用して、workflow.cityの天気と交通データを取得する。条件に基づき、最適な移動時間を返す。失敗を処理する。
.webp)
.svg)
