AIエージェントのリストを取得

cURL

curl -i -X GET "https://api.box.com/2.0/ai_agents" \
     -H "authorization: Bearer <ACCESS_TOKEN>"

{
  "entries": [
    {
      "id": "1234567890",
      "origin": "CUSTOM",
      "name": "This is my Agent",
      "access_state": "enabled",
      "type": "ai_agent",
      "created_by": {
        "id": "11446498",
        "type": "user"
      },
      "created_at": "2022-01-01T00:00:00Z",
      "modified_by": {
        "id": "11446498",
        "type": "user"
      },
      "modified_at": "2022-01-01T00:00:00Z",
      "icon_reference": "https://cdn01.boxcdn.net/app-assets/aistudio/avatars/logo_analytics.svg",
      "allowed_entities": [
        {
          "id": "11446498",
          "type": "user"
        }
      ],
      "ask": {
        "type": "ai_agent_ask",
        "access_state": "enabled",
        "description": "This is ASK Agent",
        "custom_instructions": "This is a custom instruction",
        "suggested_questions": [
          "What is in this file?",
          "What are the main highlights of this document?"
        ],
        "long_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_image": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "spreadsheet": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "long_text_multi": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_text_multi": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_image_multi": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        }
      },
      "text_gen": {
        "type": "ai_agent_text_gen",
        "access_state": "enabled",
        "description": "This is ASK Agent",
        "custom_instructions": "This is a custom instruction",
        "suggested_questions": [
          "What is in this file?",
          "What are the main highlights of this document?"
        ],
        "basic_gen": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, and I have $8000 and want to spend a week in the Azores. `{user_question}`",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "content_template": "---{content}---",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        }
      },
      "extract": {
        "type": "ai_agent_extract",
        "access_state": "enabled",
        "description": "This is ASK Agent",
        "custom_instructions": "This is a custom instruction",
        "long_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_image": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        }
      }
    }
  ],
  "limit": 1000,
  "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
  "prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

GET

ai_agents

cURL

curl -i -X GET "https://api.box.com/2.0/ai_agents" \
     -H "authorization: Bearer <ACCESS_TOKEN>"

{
  "entries": [
    {
      "id": "1234567890",
      "origin": "CUSTOM",
      "name": "This is my Agent",
      "access_state": "enabled",
      "type": "ai_agent",
      "created_by": {
        "id": "11446498",
        "type": "user"
      },
      "created_at": "2022-01-01T00:00:00Z",
      "modified_by": {
        "id": "11446498",
        "type": "user"
      },
      "modified_at": "2022-01-01T00:00:00Z",
      "icon_reference": "https://cdn01.boxcdn.net/app-assets/aistudio/avatars/logo_analytics.svg",
      "allowed_entities": [
        {
          "id": "11446498",
          "type": "user"
        }
      ],
      "ask": {
        "type": "ai_agent_ask",
        "access_state": "enabled",
        "description": "This is ASK Agent",
        "custom_instructions": "This is a custom instruction",
        "suggested_questions": [
          "What is in this file?",
          "What are the main highlights of this document?"
        ],
        "long_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_image": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "spreadsheet": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "long_text_multi": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_text_multi": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_image_multi": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        }
      },
      "text_gen": {
        "type": "ai_agent_text_gen",
        "access_state": "enabled",
        "description": "This is ASK Agent",
        "custom_instructions": "This is a custom instruction",
        "suggested_questions": [
          "What is in this file?",
          "What are the main highlights of this document?"
        ],
        "basic_gen": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, and I have $8000 and want to spend a week in the Azores. `{user_question}`",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "content_template": "---{content}---",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        }
      },
      "extract": {
        "type": "ai_agent_extract",
        "access_state": "enabled",
        "description": "This is ASK Agent",
        "custom_instructions": "This is a custom instruction",
        "long_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "embeddings": {
            "model": "azure__openai__text_embedding_ada_002",
            "strategy": {
              "id": "basic",
              "num_tokens_per_chunk": 64
            }
          },
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_text": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        },
        "basic_image": {
          "model": "azure__openai__gpt_4o_mini",
          "num_tokens_for_completion": 8400,
          "llm_endpoint_params": {
            "type": "openai_params",
            "temperature": 0,
            "top_p": 1,
            "frequency_penalty": 1.5,
            "presence_penalty": 1.5,
            "stop": "<|im_end|>"
          },
          "system_message": "You are a helpful travel assistant specialized in budget travel",
          "prompt_template": "It is `{current_date}`, consider these travel options `{content}` and answer the `{user_question}`.",
          "is_custom_instructions_included": false,
          "warnings": [
            "MODEL_INACTIVE"
          ]
        }
      }
    }
  ],
  "limit": 1000,
  "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
  "prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

{
  "type": "error",
  "status": 400,
  "code": "item_name_invalid",
  "message": "Method Not Allowed",
  "context_info": {
    "message": "Something went wrong"
  },
  "help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
  "request_id": "abcdef123456"
}

このリソースは、バージョン2024.0のエンドポイントで使用されています。詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization

string

header

必須

The access token received from the authorization server in the OAuth 2.0 flow.

クエリパラメータ

mode

string[]

返されるエージェント構成にフィルタをかけるためのモード。使用可能な値はask、text_gen、extractです。

fields

string[]

レスポンスで返されるフィールド。

agent_state

string[]

返されるエージェントの状態。使用可能な値はenabled、disabled、enabled_for_selected_usersです。

include_box_default

boolean

デフォルト:false

レスポンスにBoxのデフォルトエージェントを含めるかどうか。

marker

string

結果が返される開始位置のマーカー。

limit

integer<int64>

返す項目の1ページあたりの最大数。

必須範囲: x <= 1000

レスポンス

エージェントのリストを含む成功したレスポンス。

ページネーションを使用したAIエージェントのリスト。

entries

AIエージェント (Full) · object[]

必須

AIエージェントのリスト。

Show child attributes

limit

integer<int64>

これらのエントリで使用された制限値。許容される最大値を超えていない限り、クエリパラメータのlimitと等しくなります。最大値はAPIによって異なります。

例:

1000

next_marker

string | null

次の検索結果ページの開始場所のマーカー。

例:

"JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii"

prev_marker

string | null

前の検索結果ページの開始場所のマーカー。

例:

"JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"

最終更新日 2026年1月23日

AI Studio リソース

エージェントIDを指定してAIエージェントを取得

⌘I