{ "components": { "schemas": { "AgentClaimHandoffResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "lease_expires_at": { "format": "date-time", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "disposition", "app_id", "assignment_id", "ticket_id", "conversation_id", "queue_id", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentConversationMessagesResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "lease_expires_at": { "format": "date-time", "type": "string" }, "messages": { "items": { "additionalProperties": false, "properties": { "author": { "anyOf": [ { "const": "visitor", "type": "string" }, { "const": "assistant", "type": "string" }, { "const": "human", "type": "string" }, { "const": "system", "type": "string" } ] }, "citations": { "items": { "additionalProperties": false, "properties": { "citation_id": { "pattern": "^cit_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "excerpt": { "maxLength": 1024, "minLength": 1, "type": "string" }, "title": { "maxLength": 256, "minLength": 1, "type": "string" }, "url": { "format": "uri", "maxLength": 2048, "minLength": 9, "pattern": "^https://(?![^/?#]*@)[^\\s]+$", "type": "string" } }, "required": ["citation_id", "title", "excerpt", "url"], "type": "object" }, "maxItems": 20, "type": "array" }, "created_at": { "format": "date-time", "type": "string" }, "message_id": { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "parts": { "items": { "additionalProperties": false, "properties": { "text": { "maxLength": 8000, "minLength": 1, "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": ["type", "text"], "type": "object" }, "maxItems": 20, "minItems": 1, "type": "array" } }, "required": ["message_id", "author", "parts", "citations", "created_at"], "type": "object" }, "maxItems": 100, "type": "array" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "state": { "const": "human_active", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "state", "state_version", "owner_epoch", "assignment_epoch", "lease_expires_at", "messages" ], "type": "object" }, "meta": { "additionalProperties": false, "properties": { "has_more": { "type": "boolean" }, "next_after": { "anyOf": [ { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, { "type": "null" } ] } }, "required": ["has_more", "next_after"], "type": "object" } }, "required": ["data", "meta"], "type": "object" }, "AgentCreateHumanMessageResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "event_id": { "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "event_sequence": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "lease_expires_at": { "format": "date-time", "type": "string" }, "message_id": { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "disposition", "assignment_id", "conversation_id", "message_id", "event_id", "event_sequence", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at", "created_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentCreateRealtimeTokenResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "realtime_expires_at": { "format": "date-time", "type": "string" }, "realtime_token": { "maxLength": 117, "minLength": 86, "pattern": "^arl_[A-Za-z0-9-]{1,32}_[0-9a-f-]{36}_[A-Za-z0-9_-]{43}$", "type": "string" }, "realtime_url": { "format": "uri", "maxLength": 2048, "minLength": 1, "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "disposition", "assignment_id", "conversation_id", "queue_id", "assignment_epoch", "state_version", "owner_epoch", "realtime_token", "realtime_url", "realtime_expires_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentEndHandoffResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "action": { "anyOf": [ { "const": "resume_bot", "type": "string" }, { "const": "close", "type": "string" } ] }, "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "ended_at": { "format": "date-time", "type": "string" }, "final_event_id": { "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "final_event_sequence": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state": { "anyOf": [ { "const": "bot_active", "type": "string" }, { "const": "closed", "type": "string" } ] }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "wrap_up_event_id": { "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "wrap_up_event_sequence": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "disposition", "assignment_id", "ticket_id", "conversation_id", "queue_id", "action", "state", "assignment_epoch", "state_version", "owner_epoch", "wrap_up_event_id", "wrap_up_event_sequence", "final_event_id", "final_event_sequence", "ended_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentErrorEnvelope": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" }, "AgentGetPresenceResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "disposition": { "const": "current", "type": "string" }, "effective_status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "version": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": ["status", "effective_status", "expires_at", "version", "disposition"], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentInboxListResponse": { "additionalProperties": false, "properties": { "data": { "items": { "additionalProperties": false, "properties": { "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "application_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "assigned_to_me": { "type": "boolean" }, "assignment_epoch": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, { "type": "null" } ] }, "assignment_id": { "anyOf": [ { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, { "type": "null" } ] }, "available_at": { "format": "date-time", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "priority": { "maximum": 32767, "minimum": 0, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "anyOf": [ { "const": "queued", "type": "string" }, { "const": "assigned", "type": "string" } ] }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "queue_item_id", "ticket_id", "conversation_id", "app_id", "application_name", "queue_id", "queue_name", "status", "priority", "sla_deadline_at", "available_at", "state_version", "owner_epoch", "assignment_id", "assignment_epoch", "assigned_to_me" ], "type": "object" }, "maxItems": 100, "type": "array" }, "meta": { "additionalProperties": false, "properties": { "has_more": { "type": "boolean" }, "next_after": { "anyOf": [ { "additionalProperties": false, "properties": { "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" } }, "required": ["sla_deadline_at", "queue_item_id"], "type": "object" }, { "type": "null" } ] } }, "required": ["has_more", "next_after"], "type": "object" } }, "required": ["data", "meta"], "type": "object" }, "AgentReleaseHandoffResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "released_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "const": "released", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "disposition", "assignment_id", "ticket_id", "conversation_id", "queue_id", "status", "state_version", "owner_epoch", "released_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentSetPresenceResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "disposition": { "anyOf": [ { "const": "changed", "type": "string" }, { "const": "unchanged", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "effective_status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["status", "effective_status", "expires_at", "version", "disposition"], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentSupervisorQueueMetricsResponse": { "additionalProperties": false, "properties": { "data": { "items": { "additionalProperties": false, "properties": { "active_assignments": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "average_first_human_response_seconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "number" }, { "type": "null" } ] }, "average_handle_seconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "number" }, { "type": "null" } ] }, "current_overdue": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "oldest_wait_seconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "number" }, { "type": "null" } ] }, "queue_depth": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_key": { "pattern": "^[a-z][a-z0-9_-]{0,62}$", "type": "string" }, "queue_name": { "maxLength": 120, "minLength": 1, "type": "string" }, "sla_breach_count": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "transfer_count": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "app_id", "queue_id", "queue_key", "queue_name", "queue_depth", "oldest_wait_seconds", "active_assignments", "current_overdue", "average_first_human_response_seconds", "average_handle_seconds", "transfer_count", "sla_breach_count" ], "type": "object" }, "maxItems": 100, "type": "array" }, "meta": { "additionalProperties": false, "properties": { "as_of": { "format": "date-time", "type": "string" }, "window_seconds": { "maximum": 2678400, "minimum": 300, "type": "integer" }, "window_start": { "format": "date-time", "type": "string" } }, "required": ["as_of", "window_start", "window_seconds"], "type": "object" } }, "required": ["data", "meta"], "type": "object" }, "AgentSupervisorReleaseHandoffResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "released_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "const": "released", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "disposition", "assignment_id", "ticket_id", "conversation_id", "queue_id", "status", "state_version", "owner_epoch", "released_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentSupervisorTransferHandoffResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "lease_expires_at": { "format": "date-time", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "source_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "source_queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "target_admin_account_id": { "format": "uuid", "type": "string" }, "target_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "target_queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "transferred_at": { "format": "date-time", "type": "string" } }, "required": [ "disposition", "source_assignment_id", "target_assignment_id", "target_admin_account_id", "ticket_id", "conversation_id", "source_queue_id", "target_queue_id", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at", "transferred_at" ], "type": "object" } }, "required": ["data"], "type": "object" }, "AgentSupervisorWorkItemsResponse": { "additionalProperties": false, "properties": { "data": { "items": { "additionalProperties": false, "properties": { "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "application_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "assignee_admin_account_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ] }, "assignee_email": { "anyOf": [ { "format": "email", "maxLength": 320, "minLength": 3, "type": "string" }, { "type": "null" } ] }, "assignment_epoch": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, { "type": "null" } ] }, "assignment_id": { "anyOf": [ { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, { "type": "null" } ] }, "available_at": { "format": "date-time", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "priority": { "maximum": 100, "minimum": 0, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "anyOf": [ { "const": "queued", "type": "string" }, { "const": "assigned", "type": "string" } ] }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "queue_item_id", "ticket_id", "conversation_id", "app_id", "application_name", "queue_id", "queue_name", "status", "priority", "sla_deadline_at", "available_at", "state_version", "owner_epoch", "assignment_id", "assignment_epoch", "assignee_admin_account_id", "assignee_email" ], "type": "object" }, "maxItems": 100, "type": "array" }, "meta": { "additionalProperties": false, "properties": { "has_more": { "type": "boolean" }, "next_after": { "anyOf": [ { "additionalProperties": false, "properties": { "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" } }, "required": ["sla_deadline_at", "queue_item_id"], "type": "object" }, { "type": "null" } ] } }, "required": ["has_more", "next_after"], "type": "object" } }, "required": ["data", "meta"], "type": "object" }, "AgentTransferHandoffResponse": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "lease_expires_at": { "format": "date-time", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "source_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "target_admin_account_id": { "format": "uuid", "type": "string" }, "target_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "transferred_at": { "format": "date-time", "type": "string" } }, "required": [ "disposition", "source_assignment_id", "target_assignment_id", "target_admin_account_id", "ticket_id", "conversation_id", "queue_id", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at", "transferred_at" ], "type": "object" } }, "required": ["data"], "type": "object" } }, "securitySchemes": { "agentBearer": { "scheme": "bearer", "type": "http" } } }, "info": { "title": "AI 客服 Agent API", "version": "1.0.0" }, "openapi": "3.1.0", "paths": { "/agent/v1/assignments/{assignment_id}/end": { "post": { "operationId": "agentEndHandoff", "parameters": [ { "in": "path", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action": { "anyOf": [ { "const": "resume_bot", "type": "string" }, { "const": "close", "type": "string" } ] }, "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "action", "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch" ], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "action": { "anyOf": [ { "const": "resume_bot", "type": "string" }, { "const": "close", "type": "string" } ] }, "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "ended_at": { "format": "date-time", "type": "string" }, "final_event_id": { "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "final_event_sequence": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state": { "anyOf": [ { "const": "bot_active", "type": "string" }, { "const": "closed", "type": "string" } ] }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "wrap_up_event_id": { "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "wrap_up_event_sequence": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "disposition", "assignment_id", "ticket_id", "conversation_id", "queue_id", "action", "state", "assignment_epoch", "state_version", "owner_epoch", "wrap_up_event_id", "wrap_up_event_sequence", "final_event_id", "final_event_sequence", "ended_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/assignments/{assignment_id}/realtime-tokens": { "post": { "operationId": "agentCreateRealtimeToken", "parameters": [ { "in": "path", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch" ], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "realtime_expires_at": { "format": "date-time", "type": "string" }, "realtime_token": { "maxLength": 117, "minLength": 86, "pattern": "^arl_[A-Za-z0-9-]{1,32}_[0-9a-f-]{36}_[A-Za-z0-9_-]{43}$", "type": "string" }, "realtime_url": { "format": "uri", "maxLength": 2048, "minLength": 1, "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "disposition", "assignment_id", "conversation_id", "queue_id", "assignment_epoch", "state_version", "owner_epoch", "realtime_token", "realtime_url", "realtime_expires_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/assignments/{assignment_id}/release": { "post": { "operationId": "agentReleaseHandoff", "parameters": [ { "in": "path", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch" ], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "released_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "const": "released", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "disposition", "assignment_id", "ticket_id", "conversation_id", "queue_id", "status", "state_version", "owner_epoch", "released_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/assignments/{assignment_id}/transfer": { "post": { "operationId": "agentTransferHandoff", "parameters": [ { "in": "path", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "target_admin_account_id": { "format": "uuid", "type": "string" } }, "required": [ "target_admin_account_id", "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch" ], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "lease_expires_at": { "format": "date-time", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "source_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "target_admin_account_id": { "format": "uuid", "type": "string" }, "target_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "transferred_at": { "format": "date-time", "type": "string" } }, "required": [ "disposition", "source_assignment_id", "target_assignment_id", "target_admin_account_id", "ticket_id", "conversation_id", "queue_id", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at", "transferred_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/conversations/{conversation_id}/messages": { "get": { "operationId": "agentListConversationMessages", "parameters": [ { "in": "path", "name": "conversation_id", "required": true, "schema": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "query", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "query", "name": "assignment_epoch", "required": true, "schema": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "owner_epoch", "required": true, "schema": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "after", "required": false, "schema": { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 100, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "lease_expires_at": { "format": "date-time", "type": "string" }, "messages": { "items": { "additionalProperties": false, "properties": { "author": { "anyOf": [ { "const": "visitor", "type": "string" }, { "const": "assistant", "type": "string" }, { "const": "human", "type": "string" }, { "const": "system", "type": "string" } ] }, "citations": { "items": { "additionalProperties": false, "properties": { "citation_id": { "pattern": "^cit_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "excerpt": { "maxLength": 1024, "minLength": 1, "type": "string" }, "title": { "maxLength": 256, "minLength": 1, "type": "string" }, "url": { "format": "uri", "maxLength": 2048, "minLength": 9, "pattern": "^https://(?![^/?#]*@)[^\\s]+$", "type": "string" } }, "required": ["citation_id", "title", "excerpt", "url"], "type": "object" }, "maxItems": 20, "type": "array" }, "created_at": { "format": "date-time", "type": "string" }, "message_id": { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "parts": { "items": { "additionalProperties": false, "properties": { "text": { "maxLength": 8000, "minLength": 1, "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": ["type", "text"], "type": "object" }, "maxItems": 20, "minItems": 1, "type": "array" } }, "required": [ "message_id", "author", "parts", "citations", "created_at" ], "type": "object" }, "maxItems": 100, "type": "array" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "state": { "const": "human_active", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "state", "state_version", "owner_epoch", "assignment_epoch", "lease_expires_at", "messages" ], "type": "object" }, "meta": { "additionalProperties": false, "properties": { "has_more": { "type": "boolean" }, "next_after": { "anyOf": [ { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, { "type": "null" } ] } }, "required": ["has_more", "next_after"], "type": "object" } }, "required": ["data", "meta"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] }, "post": { "operationId": "agentCreateHumanMessage", "parameters": [ { "in": "path", "name": "conversation_id", "required": true, "schema": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "parts": { "items": { "additionalProperties": false, "properties": { "text": { "maxLength": 8000, "minLength": 1, "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": ["type", "text"], "type": "object" }, "maxItems": 20, "minItems": 1, "type": "array" } }, "required": [ "assignment_id", "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch", "parts" ], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "event_id": { "pattern": "^evt_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "event_sequence": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "lease_expires_at": { "format": "date-time", "type": "string" }, "message_id": { "pattern": "^msg_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "disposition", "assignment_id", "conversation_id", "message_id", "event_id", "event_sequence", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at", "created_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/handoffs/{ticket_id}/claim": { "post": { "operationId": "agentClaimHandoff", "parameters": [ { "in": "path", "name": "ticket_id", "required": true, "schema": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": ["expected_state_version", "expected_owner_epoch"], "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "lease_expires_at": { "format": "date-time", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "disposition", "app_id", "assignment_id", "ticket_id", "conversation_id", "queue_id", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/inbox": { "get": { "operationId": "agentListInbox", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "items": { "additionalProperties": false, "properties": { "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "application_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "assigned_to_me": { "type": "boolean" }, "assignment_epoch": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, { "type": "null" } ] }, "assignment_id": { "anyOf": [ { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, { "type": "null" } ] }, "available_at": { "format": "date-time", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "priority": { "maximum": 32767, "minimum": 0, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "anyOf": [ { "const": "queued", "type": "string" }, { "const": "assigned", "type": "string" } ] }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "queue_item_id", "ticket_id", "conversation_id", "app_id", "application_name", "queue_id", "queue_name", "status", "priority", "sla_deadline_at", "available_at", "state_version", "owner_epoch", "assignment_id", "assignment_epoch", "assigned_to_me" ], "type": "object" }, "maxItems": 100, "type": "array" }, "meta": { "additionalProperties": false, "properties": { "has_more": { "type": "boolean" }, "next_after": { "anyOf": [ { "additionalProperties": false, "properties": { "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" } }, "required": ["sla_deadline_at", "queue_item_id"], "type": "object" }, { "type": "null" } ] } }, "required": ["has_more", "next_after"], "type": "object" } }, "required": ["data", "meta"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/presence": { "get": { "operationId": "agentGetPresence", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "disposition": { "const": "current", "type": "string" }, "effective_status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "version": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "status", "effective_status", "expires_at", "version", "disposition" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求无效", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] }, "put": { "operationId": "agentSetPresence", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] } }, "required": ["status"], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "disposition": { "anyOf": [ { "const": "changed", "type": "string" }, { "const": "unchanged", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "effective_status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "const": "available", "type": "string" }, { "const": "away", "type": "string" }, { "const": "offline", "type": "string" } ] }, "version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "status", "effective_status", "expires_at", "version", "disposition" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/supervisor/assignments/{assignment_id}/release": { "post": { "operationId": "agentSupervisorReleaseHandoff", "parameters": [ { "in": "path", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "released_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "const": "released", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "disposition", "assignment_id", "ticket_id", "conversation_id", "queue_id", "status", "state_version", "owner_epoch", "released_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/supervisor/assignments/{assignment_id}/transfer": { "post": { "operationId": "agentSupervisorTransferHandoff", "parameters": [ { "in": "path", "name": "assignment_id", "required": true, "schema": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 128, "minLength": 16, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "expected_assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "expected_state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "target_admin_account_id": { "format": "uuid", "type": "string" }, "target_queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "target_queue_id", "target_admin_account_id", "expected_assignment_epoch", "expected_state_version", "expected_owner_epoch" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "additionalProperties": false, "properties": { "assignment_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "disposition": { "anyOf": [ { "const": "created", "type": "string" }, { "const": "replayed", "type": "string" } ] }, "lease_expires_at": { "format": "date-time", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "source_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "source_queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "target_admin_account_id": { "format": "uuid", "type": "string" }, "target_assignment_id": { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "target_queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "transferred_at": { "format": "date-time", "type": "string" } }, "required": [ "disposition", "source_assignment_id", "target_assignment_id", "target_admin_account_id", "ticket_id", "conversation_id", "source_queue_id", "target_queue_id", "assignment_epoch", "state_version", "owner_epoch", "lease_expires_at", "transferred_at" ], "type": "object" } }, "required": ["data"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/supervisor/queue-metrics": { "get": { "operationId": "agentSupervisorListQueueMetrics", "parameters": [ { "in": "query", "name": "window_seconds", "required": false, "schema": { "maximum": 2678400, "minimum": 300, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "items": { "additionalProperties": false, "properties": { "active_assignments": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "average_first_human_response_seconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "number" }, { "type": "null" } ] }, "average_handle_seconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "number" }, { "type": "null" } ] }, "current_overdue": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "oldest_wait_seconds": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 0, "type": "number" }, { "type": "null" } ] }, "queue_depth": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_key": { "pattern": "^[a-z][a-z0-9_-]{0,62}$", "type": "string" }, "queue_name": { "maxLength": 120, "minLength": 1, "type": "string" }, "sla_breach_count": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "transfer_count": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "app_id", "queue_id", "queue_key", "queue_name", "queue_depth", "oldest_wait_seconds", "active_assignments", "current_overdue", "average_first_human_response_seconds", "average_handle_seconds", "transfer_count", "sla_breach_count" ], "type": "object" }, "maxItems": 100, "type": "array" }, "meta": { "additionalProperties": false, "properties": { "as_of": { "format": "date-time", "type": "string" }, "window_seconds": { "maximum": 2678400, "minimum": 300, "type": "integer" }, "window_start": { "format": "date-time", "type": "string" } }, "required": ["as_of", "window_start", "window_seconds"], "type": "object" } }, "required": ["data", "meta"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } }, "/agent/v1/supervisor/work-items": { "get": { "operationId": "agentSupervisorListWorkItems", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "data": { "items": { "additionalProperties": false, "properties": { "app_id": { "pattern": "^app_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "application_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "assignee_admin_account_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ] }, "assignee_email": { "anyOf": [ { "format": "email", "maxLength": 320, "minLength": 3, "type": "string" }, { "type": "null" } ] }, "assignment_epoch": { "anyOf": [ { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, { "type": "null" } ] }, "assignment_id": { "anyOf": [ { "pattern": "^ha_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, { "type": "null" } ] }, "available_at": { "format": "date-time", "type": "string" }, "conversation_id": { "pattern": "^conv_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "owner_epoch": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "priority": { "maximum": 100, "minimum": 0, "type": "integer" }, "queue_id": { "pattern": "^sq_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "queue_name": { "maxLength": 128, "minLength": 1, "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" }, "state_version": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "status": { "anyOf": [ { "const": "queued", "type": "string" }, { "const": "assigned", "type": "string" } ] }, "ticket_id": { "pattern": "^ht_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } }, "required": [ "queue_item_id", "ticket_id", "conversation_id", "app_id", "application_name", "queue_id", "queue_name", "status", "priority", "sla_deadline_at", "available_at", "state_version", "owner_epoch", "assignment_id", "assignment_epoch", "assignee_admin_account_id", "assignee_email" ], "type": "object" }, "maxItems": 100, "type": "array" }, "meta": { "additionalProperties": false, "properties": { "has_more": { "type": "boolean" }, "next_after": { "anyOf": [ { "additionalProperties": false, "properties": { "queue_item_id": { "pattern": "^hqi_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" }, "sla_deadline_at": { "format": "date-time", "type": "string" } }, "required": ["sla_deadline_at", "queue_item_id"], "type": "object" }, { "type": "null" } ] } }, "required": ["has_more", "next_after"], "type": "object" } }, "required": ["data", "meta"], "type": "object" } } }, "description": "成功", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "Retry-After": { "required": true, "schema": { "pattern": "^[0-9]+$", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "maxLength": 64, "minLength": 1, "type": "string" }, "message": { "maxLength": 512, "minLength": 1, "type": "string" } }, "required": ["code", "message"], "type": "object" } }, "required": ["error"], "type": "object" } } }, "description": "请求失败", "headers": { "Cache-Control": { "required": true, "schema": { "const": "no-store", "type": "string" } }, "Referrer-Policy": { "required": true, "schema": { "const": "no-referrer", "type": "string" } }, "X-Content-Type-Options": { "required": true, "schema": { "const": "nosniff", "type": "string" } }, "X-Trace-Id": { "required": true, "schema": { "pattern": "^tr_[0-9A-HJKMNP-TV-Z]{26}$", "type": "string" } } } } }, "security": [ { "agentBearer": [] } ] } } } }