document.py 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384
  1. import json
  2. from flask import request
  3. from flask_restful import reqparse, marshal
  4. from sqlalchemy import desc
  5. from werkzeug.exceptions import NotFound
  6. import services.dataset_service
  7. from controllers.service_api import api
  8. from controllers.service_api.app.error import ProviderNotInitializeError
  9. from controllers.service_api.dataset.error import ArchivedDocumentImmutableError, DocumentIndexingError, \
  10. NoFileUploadedError, TooManyFilesError
  11. from controllers.service_api.wraps import DatasetApiResource
  12. from libs.login import current_user
  13. from core.model_providers.error import ProviderTokenNotInitError
  14. from extensions.ext_database import db
  15. from fields.document_fields import document_fields, document_status_fields
  16. from models.dataset import Dataset, Document, DocumentSegment
  17. from services.dataset_service import DocumentService
  18. from services.file_service import FileService
  19. class DocumentAddByTextApi(DatasetApiResource):
  20. """Resource for documents."""
  21. def post(self, tenant_id, dataset_id):
  22. """Create document by text."""
  23. parser = reqparse.RequestParser()
  24. parser.add_argument('name', type=str, required=True, nullable=False, location='json')
  25. parser.add_argument('text', type=str, required=True, nullable=False, location='json')
  26. parser.add_argument('process_rule', type=dict, required=False, nullable=True, location='json')
  27. parser.add_argument('original_document_id', type=str, required=False, location='json')
  28. parser.add_argument('doc_form', type=str, default='text_model', required=False, nullable=False, location='json')
  29. parser.add_argument('doc_language', type=str, default='English', required=False, nullable=False,
  30. location='json')
  31. parser.add_argument('indexing_technique', type=str, choices=Dataset.INDEXING_TECHNIQUE_LIST, nullable=False,
  32. location='json')
  33. args = parser.parse_args()
  34. dataset_id = str(dataset_id)
  35. tenant_id = str(tenant_id)
  36. dataset = db.session.query(Dataset).filter(
  37. Dataset.tenant_id == tenant_id,
  38. Dataset.id == dataset_id
  39. ).first()
  40. if not dataset:
  41. raise ValueError('Dataset is not exist.')
  42. if not dataset.indexing_technique and not args['indexing_technique']:
  43. raise ValueError('indexing_technique is required.')
  44. upload_file = FileService.upload_text(args.get('text'), args.get('name'))
  45. data_source = {
  46. 'type': 'upload_file',
  47. 'info_list': {
  48. 'data_source_type': 'upload_file',
  49. 'file_info_list': {
  50. 'file_ids': [upload_file.id]
  51. }
  52. }
  53. }
  54. args['data_source'] = data_source
  55. # validate args
  56. DocumentService.document_create_args_validate(args)
  57. try:
  58. documents, batch = DocumentService.save_document_with_dataset_id(
  59. dataset=dataset,
  60. document_data=args,
  61. account=current_user,
  62. dataset_process_rule=dataset.latest_process_rule if 'process_rule' not in args else None,
  63. created_from='api'
  64. )
  65. except ProviderTokenNotInitError as ex:
  66. raise ProviderNotInitializeError(ex.description)
  67. document = documents[0]
  68. documents_and_batch_fields = {
  69. 'document': marshal(document, document_fields),
  70. 'batch': batch
  71. }
  72. return documents_and_batch_fields, 200
  73. class DocumentUpdateByTextApi(DatasetApiResource):
  74. """Resource for update documents."""
  75. def post(self, tenant_id, dataset_id, document_id):
  76. """Update document by text."""
  77. parser = reqparse.RequestParser()
  78. parser.add_argument('name', type=str, required=False, nullable=True, location='json')
  79. parser.add_argument('text', type=str, required=False, nullable=True, location='json')
  80. parser.add_argument('process_rule', type=dict, required=False, nullable=True, location='json')
  81. parser.add_argument('doc_form', type=str, default='text_model', required=False, nullable=False, location='json')
  82. parser.add_argument('doc_language', type=str, default='English', required=False, nullable=False,
  83. location='json')
  84. args = parser.parse_args()
  85. dataset_id = str(dataset_id)
  86. tenant_id = str(tenant_id)
  87. dataset = db.session.query(Dataset).filter(
  88. Dataset.tenant_id == tenant_id,
  89. Dataset.id == dataset_id
  90. ).first()
  91. if not dataset:
  92. raise ValueError('Dataset is not exist.')
  93. if args['text']:
  94. upload_file = FileService.upload_text(args.get('text'), args.get('name'))
  95. data_source = {
  96. 'type': 'upload_file',
  97. 'info_list': {
  98. 'data_source_type': 'upload_file',
  99. 'file_info_list': {
  100. 'file_ids': [upload_file.id]
  101. }
  102. }
  103. }
  104. args['data_source'] = data_source
  105. # validate args
  106. args['original_document_id'] = str(document_id)
  107. DocumentService.document_create_args_validate(args)
  108. try:
  109. documents, batch = DocumentService.save_document_with_dataset_id(
  110. dataset=dataset,
  111. document_data=args,
  112. account=current_user,
  113. dataset_process_rule=dataset.latest_process_rule if 'process_rule' not in args else None,
  114. created_from='api'
  115. )
  116. except ProviderTokenNotInitError as ex:
  117. raise ProviderNotInitializeError(ex.description)
  118. document = documents[0]
  119. documents_and_batch_fields = {
  120. 'document': marshal(document, document_fields),
  121. 'batch': batch
  122. }
  123. return documents_and_batch_fields, 200
  124. class DocumentAddByFileApi(DatasetApiResource):
  125. """Resource for documents."""
  126. def post(self, tenant_id, dataset_id):
  127. """Create document by upload file."""
  128. args = {}
  129. if 'data' in request.form:
  130. args = json.loads(request.form['data'])
  131. if 'doc_form' not in args:
  132. args['doc_form'] = 'text_model'
  133. if 'doc_language' not in args:
  134. args['doc_language'] = 'English'
  135. # get dataset info
  136. dataset_id = str(dataset_id)
  137. tenant_id = str(tenant_id)
  138. dataset = db.session.query(Dataset).filter(
  139. Dataset.tenant_id == tenant_id,
  140. Dataset.id == dataset_id
  141. ).first()
  142. if not dataset:
  143. raise ValueError('Dataset is not exist.')
  144. if not dataset.indexing_technique and not args['indexing_technique']:
  145. raise ValueError('indexing_technique is required.')
  146. # save file info
  147. file = request.files['file']
  148. # check file
  149. if 'file' not in request.files:
  150. raise NoFileUploadedError()
  151. if len(request.files) > 1:
  152. raise TooManyFilesError()
  153. upload_file = FileService.upload_file(file)
  154. data_source = {
  155. 'type': 'upload_file',
  156. 'info_list': {
  157. 'file_info_list': {
  158. 'file_ids': [upload_file.id]
  159. }
  160. }
  161. }
  162. args['data_source'] = data_source
  163. # validate args
  164. DocumentService.document_create_args_validate(args)
  165. try:
  166. documents, batch = DocumentService.save_document_with_dataset_id(
  167. dataset=dataset,
  168. document_data=args,
  169. account=dataset.created_by_account,
  170. dataset_process_rule=dataset.latest_process_rule if 'process_rule' not in args else None,
  171. created_from='api'
  172. )
  173. except ProviderTokenNotInitError as ex:
  174. raise ProviderNotInitializeError(ex.description)
  175. document = documents[0]
  176. documents_and_batch_fields = {
  177. 'document': marshal(document, document_fields),
  178. 'batch': batch
  179. }
  180. return documents_and_batch_fields, 200
  181. class DocumentUpdateByFileApi(DatasetApiResource):
  182. """Resource for update documents."""
  183. def post(self, tenant_id, dataset_id, document_id):
  184. """Update document by upload file."""
  185. args = {}
  186. if 'data' in request.form:
  187. args = json.loads(request.form['data'])
  188. if 'doc_form' not in args:
  189. args['doc_form'] = 'text_model'
  190. if 'doc_language' not in args:
  191. args['doc_language'] = 'English'
  192. # get dataset info
  193. dataset_id = str(dataset_id)
  194. tenant_id = str(tenant_id)
  195. dataset = db.session.query(Dataset).filter(
  196. Dataset.tenant_id == tenant_id,
  197. Dataset.id == dataset_id
  198. ).first()
  199. if not dataset:
  200. raise ValueError('Dataset is not exist.')
  201. if 'file' in request.files:
  202. # save file info
  203. file = request.files['file']
  204. if len(request.files) > 1:
  205. raise TooManyFilesError()
  206. upload_file = FileService.upload_file(file)
  207. data_source = {
  208. 'type': 'upload_file',
  209. 'info_list': {
  210. 'file_info_list': {
  211. 'file_ids': [upload_file.id]
  212. }
  213. }
  214. }
  215. args['data_source'] = data_source
  216. # validate args
  217. args['original_document_id'] = str(document_id)
  218. DocumentService.document_create_args_validate(args)
  219. try:
  220. documents, batch = DocumentService.save_document_with_dataset_id(
  221. dataset=dataset,
  222. document_data=args,
  223. account=dataset.created_by_account,
  224. dataset_process_rule=dataset.latest_process_rule if 'process_rule' not in args else None,
  225. created_from='api'
  226. )
  227. except ProviderTokenNotInitError as ex:
  228. raise ProviderNotInitializeError(ex.description)
  229. document = documents[0]
  230. documents_and_batch_fields = {
  231. 'document': marshal(document, document_fields),
  232. 'batch': batch
  233. }
  234. return documents_and_batch_fields, 200
  235. class DocumentDeleteApi(DatasetApiResource):
  236. def delete(self, tenant_id, dataset_id, document_id):
  237. """Delete document."""
  238. document_id = str(document_id)
  239. dataset_id = str(dataset_id)
  240. tenant_id = str(tenant_id)
  241. # get dataset info
  242. dataset = db.session.query(Dataset).filter(
  243. Dataset.tenant_id == tenant_id,
  244. Dataset.id == dataset_id
  245. ).first()
  246. if not dataset:
  247. raise ValueError('Dataset is not exist.')
  248. document = DocumentService.get_document(dataset.id, document_id)
  249. # 404 if document not found
  250. if document is None:
  251. raise NotFound("Document Not Exists.")
  252. # 403 if document is archived
  253. if DocumentService.check_archived(document):
  254. raise ArchivedDocumentImmutableError()
  255. try:
  256. # delete document
  257. DocumentService.delete_document(document)
  258. except services.errors.document.DocumentIndexingError:
  259. raise DocumentIndexingError('Cannot delete document during indexing.')
  260. return {'result': 'success'}, 200
  261. class DocumentListApi(DatasetApiResource):
  262. def get(self, tenant_id, dataset_id):
  263. dataset_id = str(dataset_id)
  264. tenant_id = str(tenant_id)
  265. page = request.args.get('page', default=1, type=int)
  266. limit = request.args.get('limit', default=20, type=int)
  267. search = request.args.get('keyword', default=None, type=str)
  268. dataset = db.session.query(Dataset).filter(
  269. Dataset.tenant_id == tenant_id,
  270. Dataset.id == dataset_id
  271. ).first()
  272. if not dataset:
  273. raise NotFound('Dataset not found.')
  274. query = Document.query.filter_by(
  275. dataset_id=str(dataset_id), tenant_id=tenant_id)
  276. if search:
  277. search = f'%{search}%'
  278. query = query.filter(Document.name.like(search))
  279. query = query.order_by(desc(Document.created_at))
  280. paginated_documents = query.paginate(
  281. page=page, per_page=limit, max_per_page=100, error_out=False)
  282. documents = paginated_documents.items
  283. response = {
  284. 'data': marshal(documents, document_fields),
  285. 'has_more': len(documents) == limit,
  286. 'limit': limit,
  287. 'total': paginated_documents.total,
  288. 'page': page
  289. }
  290. return response
  291. class DocumentIndexingStatusApi(DatasetApiResource):
  292. def get(self, tenant_id, dataset_id, batch):
  293. dataset_id = str(dataset_id)
  294. batch = str(batch)
  295. tenant_id = str(tenant_id)
  296. # get dataset
  297. dataset = db.session.query(Dataset).filter(
  298. Dataset.tenant_id == tenant_id,
  299. Dataset.id == dataset_id
  300. ).first()
  301. if not dataset:
  302. raise NotFound('Dataset not found.')
  303. # get documents
  304. documents = DocumentService.get_batch_documents(dataset_id, batch)
  305. if not documents:
  306. raise NotFound('Documents not found.')
  307. documents_status = []
  308. for document in documents:
  309. completed_segments = DocumentSegment.query.filter(DocumentSegment.completed_at.isnot(None),
  310. DocumentSegment.document_id == str(document.id),
  311. DocumentSegment.status != 're_segment').count()
  312. total_segments = DocumentSegment.query.filter(DocumentSegment.document_id == str(document.id),
  313. DocumentSegment.status != 're_segment').count()
  314. document.completed_segments = completed_segments
  315. document.total_segments = total_segments
  316. if document.is_paused:
  317. document.indexing_status = 'paused'
  318. documents_status.append(marshal(document, document_status_fields))
  319. data = {
  320. 'data': documents_status
  321. }
  322. return data
  323. api.add_resource(DocumentAddByTextApi, '/datasets/<uuid:dataset_id>/document/create_by_text')
  324. api.add_resource(DocumentAddByFileApi, '/datasets/<uuid:dataset_id>/document/create_by_file')
  325. api.add_resource(DocumentUpdateByTextApi, '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/update_by_text')
  326. api.add_resource(DocumentUpdateByFileApi, '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/update_by_file')
  327. api.add_resource(DocumentDeleteApi, '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>')
  328. api.add_resource(DocumentListApi, '/datasets/<uuid:dataset_id>/documents')
  329. api.add_resource(DocumentIndexingStatusApi, '/datasets/<uuid:dataset_id>/documents/<string:batch>/indexing-status')