エージェントの作成
エージェントの作成
Box AI Studioは、Enterprise Advancedアカウントでのみ使用できます。
POST /2.0/ai_agents
エンドポイントを使用すると、新しいカスタムAIエージェントを作成できます。
リクエストの送信
リクエストを送信するには、POST /2.0/ai_agents
エンドポイントを使用します。
アプリを承認するための開発者トークンを生成済みであることを確認します。詳細については、Box AIの使い方を参照してください。
パラメータ
コールを実行するには、以下のパラメータを渡す必要があります。必須のパラメータは太字で示されています。
パラメータ | 説明 | 例 |
---|---|---|
type | クエリの処理に使用されるエージェントのタイプ。 | ai_agent |
name | AIエージェントの名前。 | My AI Agent |
access_state | AIエージェントの状態。値はenabled 、disabled のいずれかです。 | enabled |
icon_reference | AIエージェントのアイコン参照。これは、URL https://cdn01.boxcdn.net/app-assets/aistudio/avatars/<file_name> の形式で指定する必要があります。この場合、file_name に使用可能な値はlogo_boxAi.png 、logo_stamp.png 、logo_legal.png 、logo_finance.png 、logo_config.png 、logo_handshake.png 、logo_analytics.png 、logo_classification.png です。 | https://cdn01.boxcdn.net/app-assets/aistudio/avatars/logo_analytics.svg |
allowed_entities | 許可するユーザーまたはグループのリスト。 | |
ask | 質問に使用されるAIエージェント。 | ask |
extract | 抽出に使用されるAIエージェント。 | |
text_gen | テキストの生成に使用されるAIエージェント。 |