{"success":true,"schema_version":"1.0.0","request_id":"req_a430c8f47c274336b704ec955f65111c","timestamp":"2026-11-01T17:40:37.625Z","result":{"id":"F41","name":"create_pdf_form","title":"创建可填表单","status":"available","phase":"P1","group":"forms","description":"Add explicitly positioned AcroForm fields to a PDF. Do not use to generate legally certified forms or dynamic XFA documents. 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. 字段名去重；坐标合法；无自动提交动作。","rest":{"method":"POST","path":"/api/v1/pdf/create-form"},"required_scopes":["jobs:create","files:read","pdf:transform"],"engine":"worker_small_or_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":{"fields":{"type":"array","description":"Field definitions","items":{"type":"object","properties":{"name":{"type":"string","description":"Unique name"},"type":{"type":"string","description":"Type","enum":["text","checkbox","dropdown"]},"region":{"type":"object","properties":{"page_number":{"type":"integer","description":"One-based page","minimum":1},"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["page_number","x","y","width","height"],"additionalProperties":false},"required":{"type":"boolean","description":"Required field","default":false},"options":{"type":"array","description":"Dropdown options","items":{"type":"string","description":"Option"},"minItems":1,"maxItems":100}},"required":["name","type","region"],"additionalProperties":false},"minItems":1,"maxItems":500}},"required":["fields"],"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":{"fields":{"type":"array","description":"Field definitions","items":{"type":"object","properties":{"name":{"type":"string","description":"Unique name"},"type":{"type":"string","description":"Type","enum":["text","checkbox","dropdown"]},"region":{"type":"object","properties":{"page_number":{"type":"integer","description":"One-based page","minimum":1},"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["page_number","x","y","width","height"],"additionalProperties":false},"required":{"type":"boolean","description":"Required field","default":false},"options":{"type":"array","description":"Dropdown options","items":{"type":"string","description":"Option"},"minItems":1,"maxItems":100}},"required":["name","type","region"],"additionalProperties":false},"minItems":1,"maxItems":500}},"required":["fields"],"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":["form.pdf"],"limits_and_semantics":"字段名去重；坐标合法；无自动提交动作。","acceptance":"可在独立查看器读取与填写；重复名拒绝。","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/create_pdf_form","accepted_input_media_types":["application/pdf"],"accepted_file_states":["ready"],"availability_reason":"Worker runtime enabled"},"sources":[],"cache":{"hit":false,"age_seconds":0},"next_actions":[]}