box-platform-openapi-agent/skills/ai/SKILL.md

name, description

name	description
ai-routes	Handle 4 OpenAPI operation(s) under /ai for the ai route group.

ai API Routes

Handle 4 OpenAPI operation(s) under /ai for the ai route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

post_ai_ask

• Operation ID: post_ai_ask
• Route: POST /ai/ask
• Mode: WRITE
• Summary: Ask question
• Body: JSON request body accepted.

post_ai_text_gen

• Operation ID: post_ai_text_gen
• Route: POST /ai/text_gen
• Mode: WRITE
• Summary: Generate text
• Body: JSON request body accepted.

post_ai_extract

• Operation ID: post_ai_extract
• Route: POST /ai/extract
• Mode: WRITE
• Summary: Extract metadata (freeform)
• Body: JSON request body accepted.

post_ai_extract_structured

• Operation ID: post_ai_extract_structured
• Route: POST /ai/extract_structured
• Mode: WRITE
• Summary: Extract metadata (structured)
• Body: JSON request body accepted.