document.py 15 KB

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