Box Developerドキュメント
ログイン

エージェントの作成

ガイド Box AI Studio AI Studioエージェント エージェントの作成

エージェントの作成

Box AI Studioは、Enterprise Advancedアカウントでのみ使用できます。

POST /2.0/ai_agentsエンドポイントを使用すると、新しいカスタムAIエージェントを作成できます。

リクエストの送信

リクエストを送信するには、POST /2.0/ai_agentsエンドポイントを使用します。

アプリを承認するための開発者トークンを生成済みであることを確認します。詳細については、Box AIの使い方を参照してください。

Node/TypeScript v10
await client.aiStudio.createAiAgent({
  name: agentName,
  accessState: 'enabled',
  ask: new AiStudioAgentAsk({ accessState: 'enabled', description: 'desc1' }),
} satisfies CreateAiAgentInput);
Python v10
client.ai_studio.create_ai_agent(
    agent_name,
    "enabled",
    ask=AiStudioAgentAsk(access_state="enabled", description="desc1"),
)
.NET v10
await client.AiStudio.CreateAiAgentAsync(requestBody: new CreateAiAgent(name: agentName, accessState: "enabled") { Ask = new AiStudioAgentAsk(accessState: "enabled", description: "desc1") });
Swift v10
try await client.aiStudio.createAiAgent(requestBody: CreateAiAgent(name: agentName, accessState: "enabled", ask: AiStudioAgentAsk(accessState: "enabled", description: "desc1")))
Java v10
client.getAiStudio().createAiAgent(new CreateAiAgent.Builder(agentName, "enabled").ask(new AiStudioAgentAsk("enabled", "desc1")).build())

パラメータ

コールを実行するには、以下のパラメータを渡す必要があります。必須のパラメータは太字で示されています。

パラメータ説明例
typeクエリの処理に使用されるエージェントのタイプ。ai_agent
nameAIエージェントの名前。My AI Agent
access_stateAIエージェントの状態。値はenabled、disabledのいずれかです。enabled
icon_referenceAIエージェントのアイコン参照。これは、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エージェント。