- Botpress Execute Code Cardを使用すると、ボットワークフロー内でカスタムJavaScriptを実行し、標準のビルトインアクションを超えるダイナミックなAPIコール、データ処理、パーソナライズされたロジックを可能にします。
- 主な使用例としては、動的なAPIリクエスト、LLM 出力の後処理、レート制限、権限チェック、複数ステップのAPI呼び出しの連鎖などがあり、AIエージェントは複雑なワークフローを正確に処理できる。
- ベストプラクティスには、APIキーを環境変数で保護すること、エラーとタイムアウトを優雅に処理すること、堅牢で安全なボット操作のための条件ロジックを構築することなどが含まれ、スムーズでスケーラブルなAPI統合を保証する。
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エージェントの操作を効率化します。ワークフローへの追加は簡単です：
追加されたら、エージェントのワークフローで活用する主な方法を紹介します。
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)
AIエージェントのためのシームレスなAPI統合
AIエージェントは、リアルタイムのデータを利用し、ワークフローを自動化し、外部サービスと接続することができれば、最高の機能を発揮する。
Botpress Hub 、API統合、自動化ツール、すぐに使えるコネクターがあらかじめ用意されているため、このような作業をシームレスに行うことができます。
パワフルなAPIをボットのワークフローに今すぐ統合しましょう。
よくあるご質問
1.Execute Code Cardを効果的に使うにはJavaScriptの知識が必要ですか？
必ずしもそうではない。基本的なことを知っていることは助けになるが、このカードにはAIが生成したコードの提案も含まれている。あなたが何をしたいのかを説明するだけで、AIはあなたのためにいくつかのスターターコードを書いてくれます。
2.一般的なAPI統合のためのテンプレートや定型コードスニペットはありますか？
はい、Botpress 、天気API、CRM、または決済サービスを呼び出すような一般的なユースケースの例とコミュニティ共有のスニペットを提供しています。
3.API インテグレーションの経験がなくても Execute Code Card を使用できますか？
もちろんです。APIに不慣れな方でも、カードに内蔵されたAIがプロンプトでガイドしてくれますし、ビジュアルなワークフロー・ビルダーがプロセス全体をより直感的にしてくれます。
4.長いAPIリクエストやタイムアウトをどのように処理しますか？
awaitで非同期JavaScriptをサポートしているが、タイムアウト処理をtry/catchとフォールバック・ロジックを使って手動で組み込み、物事をスムーズに進めたいだろう。
5.カードを使った認証と認可を実施するためのベストプラクティスとは？
機密キーを環境変数に安全に格納し、API認証にトークンやヘッダーを使用し、コードに条件ロジックを追加して、処理を進める前にユーザーのロールやアクセスレベルをチェックする。
.webp)
