Creates a custom AI agent in Box AI Studio. At least one capability required: ask (Q&A), text_gen (content generation), or extract (metadata extraction). Requirements: Box Enterprise Advanced account, Box AI Studio enabled, "Manage AI" scope in Developer Console. Access options:…
nameRequiredstringThe display name of the AI Agent visible to users in the Box interface.
typestringThe type of agent. Must be 'ai_agent'.
ask__typestringType identifier for ask capability. Must be 'ai_agent_ask' when enabling this capability.
access_statestringAccess control for the agent. Options: 'enabled' (all enterprise users), 'disabled' (no access), 'enabled_for_selected_users' (only specified users/groups in allowed_entities).
extract__typestringType identifier for extract capability. Must be 'ai_agent_extract' when enabling this capability.
icon_referencestringAvatar icon URL for the agent. Format: https://cdn01.boxcdn.net/app-assets/aistudio/avatars/<file_name>. Available icons: logo_boxAi, logo_stamp, logo_legal, logo_finance, logo_config, logo_handshake, logo_analytics, logo_classification (both .png and .svg supported). Example: h…
text__gen__typestringType identifier for text generation capability. Must be 'ai_agent_text_gen' when enabling this capability.
allowed_entitiesarrayUsers/groups with access when access_state='enabled_for_selected_users'. Format: [{'type': 'user'|'group', 'id': '<entity_id>'}]
ask__descriptionstringUser-facing description of what questions this agent can answer.
ask__access__statestringEnable state for ask capability. Options: 'enabled', 'disabled'.
extract__descriptionstringUser-facing description of what metadata/data this agent can extract from documents.
extract__access__statestringEnable state for extract capability. Options: 'enabled', 'disabled'.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
OAuth connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.