{"success":true,"schema_version":"1.0.0","request_id":"req_4a429cc63bf74cd882bd85c68207b34f","timestamp":"2026-11-01T14:52:00.154Z","result":{"id":"F09","name":"chunk_pdf_document","title":"生成RAG分块","status":"available","phase":"P1","group":"extract","description":"Create source-linked chunks from a document for retrieval pipelines. Do not use this as automatic permission to persist vectors or send text to an embedding provider. Inputs: 1–1 immutable authorized files and the typed parameters below. Returns an asynchronous job, not the final PDF. Poll get_pdf_job, then read artifacts and the receipt. The operation creates stored outputs and may incur charges; specify a cost ceiling. tokenizer版本锁定；长表单独策略；chunk_id依赖解析版本。","rest":{"method":"POST","path":"/api/v1/pdf/chunk"},"required_scopes":["jobs:create","files:read","pdf:extract"],"engine":"container","rest_input_schema":{"type":"object","properties":{"file_ids":{"type":"array","description":"Ordered authorized immutable inputs","items":{"type":"string","description":"Authorized immutable file ID.","pattern":"^fil_[A-Za-z0-9_-]+$"},"minItems":1,"maxItems":1},"parameters":{"type":"object","properties":{"max_tokens":{"type":"integer","description":"Maximum estimated tokens per chunk","minimum":64,"maximum":4096},"overlap_tokens":{"type":"integer","description":"Overlap token count; must be less than max_tokens","minimum":0,"maximum":512},"tokenizer":{"type":"string","description":"Pinned tokenizer identifier"},"preserve_tables":{"type":"boolean","description":"Keep tables together when within budget","default":true}},"required":["max_tokens","tokenizer"],"additionalProperties":false},"execution":{"$ref":"#/components/schemas/Execution"},"client_task_id":{"type":"string","description":"Caller correlation, not an authorization token","maxLength":128}},"required":["file_ids","parameters","execution"],"additionalProperties":false},"input_schema":{"type":"object","properties":{"file_ids":{"type":"array","description":"Ordered authorized immutable inputs","items":{"type":"string","description":"Authorized immutable file ID.","pattern":"^fil_[A-Za-z0-9_-]+$"},"minItems":1,"maxItems":1},"parameters":{"type":"object","properties":{"max_tokens":{"type":"integer","description":"Maximum estimated tokens per chunk","minimum":64,"maximum":4096},"overlap_tokens":{"type":"integer","description":"Overlap token count; must be less than max_tokens","minimum":0,"maximum":512},"tokenizer":{"type":"string","description":"Pinned tokenizer identifier"},"preserve_tables":{"type":"boolean","description":"Keep tables together when within budget","default":true}},"required":["max_tokens","tokenizer"],"additionalProperties":false},"execution":{"$ref":"#/components/schemas/Execution"},"client_task_id":{"type":"string","description":"Caller correlation, not an authorization token","maxLength":128},"idempotency_key":{"type":"string","description":"Required project/operation scoped deduplication key shared with REST Idempotency-Key","minLength":8,"maxLength":128}},"required":["file_ids","parameters","execution","idempotency_key"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"success":{"const":true},"schema_version":{"const":"1.0.0"},"request_id":{"type":"string","description":"Request ID"},"timestamp":{"type":"string","description":"Server response time","format":"date-time"},"result":{"$ref":"#/components/schemas/Job"},"sources":{"type":"array","description":"Input provenance","items":{"$ref":"#/components/schemas/Source"},"minItems":0,"maxItems":100},"cache":{"type":"object","properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer","description":"Cache age","minimum":0}},"required":["hit","age_seconds"],"additionalProperties":false},"next_actions":{"type":"array","description":"Non-executing suggestions","items":{"type":"object","properties":{"tool":{"type":"string","description":"Tool name"},"arguments":{"type":"object"},"reason":{"type":"string","description":"Reason"},"required_scopes":{"type":"array","description":"Scopes still enforced","items":{"type":"string","description":"Scope"},"minItems":0,"maxItems":20},"requires_confirmation":{"type":"boolean"}},"required":["tool","arguments","reason","required_scopes","requires_confirmation"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["success","schema_version","request_id","timestamp","result","sources","next_actions"],"additionalProperties":false},"result_artifact_types":["chunks.jsonl"],"limits_and_semantics":"tokenizer版本锁定；长表单独策略；chunk_id依赖解析版本。","acceptance":"分块无页遗漏；overlap可计算；每块可还原来源范围。","mcp_annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"idempotency":"REST Idempotency-Key / MCP idempotency_key required; shared project/operation deduplication for at least 24h.","doc_url":"/api/v1/capabilities/chunk_pdf_document","accepted_input_media_types":["application/pdf"],"accepted_file_states":["ready"],"availability_reason":"Worker runtime enabled"},"sources":[],"cache":{"hit":false,"age_seconds":0},"next_actions":[]}