コード実行カードを使ってAIエージェント内でコードを実行する

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を使用すると、ユーザーの意図、ボットのコンテキスト、または以前の会話に基づいて動的にリクエストを変更することができます。

例ユーザー設定に基づくカスタムデータの取得。

プロンプト旅行チャットボットは、ユーザーの目的地、旅行日、予算に基づいてホテルの価格を取得する必要があります。

‍注意 Execute Code Cardは自然言語からコードを生成することができます。ただし、常に 変数 を検証してください。

2.LLM 回答の後処理

Botpress 組み込みのAIアクションが用意されていますが、ユーザーに表示する前に、出力をフォーマットしたり、特定の単語をフィルタリングしたり、データをより明確に構造化するなど、レスポンスを微調整する必要がある場合もあります。

例：非構造化LLM 応答を定義されたテーブル/フォーマットに書き換える。

プロンプト：AIがAPIからお勧めのレストランを取得するので、表示する前にきれいな表に整形してほしい。

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.

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.

5.マルチステップAPIチェーニング

ボットが最終的なレスポンスを送信する前に、複数のAPIからデータを組み合わせる必要があることがあります。このカードは、動的にデータを取得、変換、渡すことで、複雑なマルチステップワークフローを可能にします。

例：天気予報＋レストラン予約で、最適な出発時間を提案

プロンプト：workflow.userApiKeyを使用して、workflow.cityの天気と交通データを取得する。条件に基づき、最適な移動時間を返す。失敗を処理する。

AIエージェントのためのシームレスなAPI統合

AIエージェントは、リアルタイムのデータを利用し、ワークフローを自動化し、外部サービスと接続することができれば、最高の機能を発揮する。

Botpress Hub 、API統合、自動化ツール、すぐに使えるコネクターがあらかじめ用意されているため、このような作業をシームレスに行うことができます。

パワフルなAPIをボットのワークフローに今すぐ統合しましょう。

よくあるご質問

1.Execute Code Cardを効果的に使うにはJavaScriptの知識が必要ですか？

Execute Code Cardを効果的に使うのにJavaScriptの深い知識は必要ありません。Botpress AIによるコードサジェストを提供し、あなたが望むものを記述すると、最小限の労力で調整できるスターターコードを生成します。

2.一般的なAPI統合のためのテンプレートや定型コードスニペットはありますか？

はい、Botpress 、CRMや決済ゲートウェイなどの一般的なAPI統合のための組み込み例と定型コードスニペットを提供しています。また、コミュニティフォーラムを閲覧して、すぐに使えるコードパターンを探すこともできます。

3.API インテグレーションの経験がなくても Execute Code Card を使用できますか？

API インテグレーションの経験がなくても、コード実行カードは使えます。インターフェイスは初心者に優しく、BotpressAIヘルパーがコードを生成して説明してくれるので、開発者でなくても学習曲線を管理できます。

4.長いAPIリクエストやタイムアウトをどのように処理しますか？

コード実行カードは、非同期 JavaScript をサポートしています。 非同期/待機しかし、タイムアウトや失敗を手動で処理する必要がある。ベストプラクティスとしては、APIコールを トライ/キャッチ ブロックを定義し、応答が遅れたり失敗した場合のフォールバック・フローを定義する。

5.カードを使った認証と認可を実施するためのベストプラクティスとは？

コード実行カードで認証と認可を実装する場合、APIキーまたはトークンをBotpress 環境変数に格納し、セキュアヘッダー経由で送信し、機密性の高いアクションを実行する前にユーザーのロールまたは権限を検証するロジックを含める必要があります。