{"success":true,"schema_version":"1.0.0","request_id":"req_4da44def844245ad92a04639fce225b4","timestamp":"2026-11-01T14:48:52.843Z","result":{"id":"F03","name":"extract_pdf_markdown","title":"提取Markdown","status":"available","phase":"P0","group":"extract","description":"Convert document reading structure to Markdown with source block mapping. Do not use when exact visual reproduction is required; use render_pdf_pages. 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. 标题推断标inferred；表格无法可靠恢复时保留原块；不静默OCR。","rest":{"method":"POST","path":"/api/v1/pdf/extract-markdown"},"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":{"pages":{"type":"array","description":"One-based page numbers; omitted means all pages.","items":{"type":"integer","description":"Page number","minimum":1},"minItems":1,"maxItems":2000},"include_tables":{"type":"boolean","description":"Include detected tables","default":true},"include_images":{"type":"boolean","description":"Reference extracted images","default":false},"heading_mode":{"type":"string","description":"Heading detection","enum":["conservative","layout"],"default":"conservative"}},"required":[],"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":{"pages":{"type":"array","description":"One-based page numbers; omitted means all pages.","items":{"type":"integer","description":"Page number","minimum":1},"minItems":1,"maxItems":2000},"include_tables":{"type":"boolean","description":"Include detected tables","default":true},"include_images":{"type":"boolean","description":"Reference extracted images","default":false},"heading_mode":{"type":"string","description":"Heading detection","enum":["conservative","layout"],"default":"conservative"}},"required":[],"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":["document.md","blocks.jsonl"],"limits_and_semantics":"标题推断标inferred；表格无法可靠恢复时保留原块；不静默OCR。","acceptance":"每段Markdown有block映射，图片使用授权artifact引用，不嵌任意远程URL。","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/extract_pdf_markdown","accepted_input_media_types":["application/pdf"],"accepted_file_states":["ready"],"availability_reason":"Worker runtime enabled"},"sources":[],"cache":{"hit":false,"age_seconds":0},"next_actions":[]}