box_ai_ask_file_multi_tool
Query Box AI using a specific prompt to analyze and generate responses based on content from multiple files stored in Box.
Instructions
Ask Box AI about multiple files. This tool allows users to query Box AI with a specific prompt, leveraging the content of multiple files stored in Box. The AI processes the files and generates a response based on the provided prompt. Args: ctx (Context): The context object containing the request and lifespan context. file_ids (List[str]): A list of IDs of the files to be analyzed by the AI. prompt (str): The prompt or question to ask the AI. ai_agent_id (Optional[str]): The ID of the AI agent to use for processing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ai_agent_id | No | ||
| file_ids | Yes | ||
| prompt | Yes |
Implementation Reference
- src/tools/box_tools_ai.py:42-59 (handler)The main handler function for the box_ai_ask_file_multi_tool MCP tool. It retrieves the Box client and calls the underlying box_ai_ask_file_multi function.async def box_ai_ask_file_multi_tool( ctx: Context, file_ids: List[str], prompt: str, ai_agent_id: Optional[str] = None ) -> dict: """ Ask a question about multiple files using AI. Args: ctx (Context): The context object containing the request and lifespan context. file_ids (List[str]): A list of file IDs to ask about, example: ["1234567890", "0987654321"]. prompt (str): The question to ask. ai_agent_id (Optional[str]): The ID of the AI agent to use for the question. If None, the default AI agent will be used. Returns: dict: The AI response containing the answers to the questions for each file. """ box_client = get_box_client(ctx) response = box_ai_ask_file_multi( box_client, file_ids, prompt=prompt, ai_agent_id=ai_agent_id ) return response
- src/tool_registry/ai_tools.py:20-20 (registration)Registration of the box_ai_ask_file_multi_tool using mcp.tool() decorator in the register_ai_tools function.mcp.tool()(box_ai_ask_file_multi_tool)
- src/tool_registry/ai_tools.py:7-7 (registration)Import of the box_ai_ask_file_multi_tool handler from tools.box_tools_ai.box_ai_ask_file_multi_tool,