メインコンテンツへスキップ
Box AI Studioは、Enterprise Advancedアカウントでのみ使用できます。
POST /2.0/ai_agentsエンドポイントによって、質問の投げかけ、テキストの生成、メタデータの抽出といった構成可能な機能を持つ、新しいカスタムを作成できます。

開始する前に

Platformアプリを作成し、開発者トークンを生成するには、の手順を完了していることを確認してください。

リクエストの送信

await client.aiStudio.createAiAgent({
  name: agentName,
  accessState: 'enabled',
  ask: new AiStudioAgentAsk({ accessState: 'enabled', description: 'desc1' }),
} satisfies CreateAiAgentInput);

パラメータ

コールを実行するには、以下のパラメータを渡す必要があります。必須のパラメータは太字で示されています。
パラメータ説明
typeクエリの処理に使用されるエージェントのタイプ。ai_agent
nameAIエージェントの名前。My AI Agent
access_stateAIエージェントの状態。値はenableddisabledのいずれかです。enabled
icon_referenceAIエージェントのアイコン参照。これは、URL https://cdn01.boxcdn.net/app-assets/aistudio/avatars/<file_name>の形式で指定する必要があります。この場合、file_nameに使用可能な値はlogo_boxAi.pnglogo_stamp.pnglogo_legal.pnglogo_finance.pnglogo_config.pnglogo_handshake.pnglogo_analytics.pnglogo_classification.pngです。https://cdn01.boxcdn.net/app-assets/aistudio/avatars/logo_analytics.svg
allowed_entities許可するユーザーまたはグループのリスト。
ask質問に使用されるAIエージェント。ask
extract抽出に使用されるAIエージェント。
text_genテキストの生成に使用されるAIエージェント。