datasets_document.py 39 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988
  1. # -*- coding:utf-8 -*-
  2. import random
  3. from datetime import datetime
  4. from typing import List
  5. from flask import request, current_app
  6. from flask_login import current_user
  7. from core.login.login import login_required
  8. from flask_restful import Resource, fields, marshal, marshal_with, reqparse
  9. from sqlalchemy import desc, asc
  10. from werkzeug.exceptions import NotFound, Forbidden
  11. import services
  12. from controllers.console import api
  13. from controllers.console.app.error import ProviderNotInitializeError, ProviderQuotaExceededError, \
  14. ProviderModelCurrentlyNotSupportError
  15. from controllers.console.datasets.error import DocumentAlreadyFinishedError, InvalidActionError, DocumentIndexingError, \
  16. InvalidMetadataError, ArchivedDocumentImmutableError
  17. from controllers.console.setup import setup_required
  18. from controllers.console.wraps import account_initialization_required
  19. from core.indexing_runner import IndexingRunner
  20. from core.model_providers.error import ProviderTokenNotInitError, QuotaExceededError, ModelCurrentlyNotSupportError, \
  21. LLMBadRequestError
  22. from core.model_providers.model_factory import ModelFactory
  23. from extensions.ext_redis import redis_client
  24. from libs.helper import TimestampField
  25. from extensions.ext_database import db
  26. from models.dataset import DatasetProcessRule, Dataset
  27. from models.dataset import Document, DocumentSegment
  28. from models.model import UploadFile
  29. from services.dataset_service import DocumentService, DatasetService
  30. from tasks.add_document_to_index_task import add_document_to_index_task
  31. from tasks.remove_document_from_index_task import remove_document_from_index_task
  32. dataset_fields = {
  33. 'id': fields.String,
  34. 'name': fields.String,
  35. 'description': fields.String,
  36. 'permission': fields.String,
  37. 'data_source_type': fields.String,
  38. 'indexing_technique': fields.String,
  39. 'created_by': fields.String,
  40. 'created_at': TimestampField,
  41. }
  42. document_fields = {
  43. 'id': fields.String,
  44. 'position': fields.Integer,
  45. 'data_source_type': fields.String,
  46. 'data_source_info': fields.Raw(attribute='data_source_info_dict'),
  47. 'dataset_process_rule_id': fields.String,
  48. 'name': fields.String,
  49. 'created_from': fields.String,
  50. 'created_by': fields.String,
  51. 'created_at': TimestampField,
  52. 'tokens': fields.Integer,
  53. 'indexing_status': fields.String,
  54. 'error': fields.String,
  55. 'enabled': fields.Boolean,
  56. 'disabled_at': TimestampField,
  57. 'disabled_by': fields.String,
  58. 'archived': fields.Boolean,
  59. 'display_status': fields.String,
  60. 'word_count': fields.Integer,
  61. 'hit_count': fields.Integer,
  62. 'doc_form': fields.String,
  63. }
  64. document_with_segments_fields = {
  65. 'id': fields.String,
  66. 'position': fields.Integer,
  67. 'data_source_type': fields.String,
  68. 'data_source_info': fields.Raw(attribute='data_source_info_dict'),
  69. 'dataset_process_rule_id': fields.String,
  70. 'name': fields.String,
  71. 'created_from': fields.String,
  72. 'created_by': fields.String,
  73. 'created_at': TimestampField,
  74. 'tokens': fields.Integer,
  75. 'indexing_status': fields.String,
  76. 'error': fields.String,
  77. 'enabled': fields.Boolean,
  78. 'disabled_at': TimestampField,
  79. 'disabled_by': fields.String,
  80. 'archived': fields.Boolean,
  81. 'display_status': fields.String,
  82. 'word_count': fields.Integer,
  83. 'hit_count': fields.Integer,
  84. 'completed_segments': fields.Integer,
  85. 'total_segments': fields.Integer
  86. }
  87. class DocumentResource(Resource):
  88. def get_document(self, dataset_id: str, document_id: str) -> Document:
  89. dataset = DatasetService.get_dataset(dataset_id)
  90. if not dataset:
  91. raise NotFound('Dataset not found.')
  92. try:
  93. DatasetService.check_dataset_permission(dataset, current_user)
  94. except services.errors.account.NoPermissionError as e:
  95. raise Forbidden(str(e))
  96. document = DocumentService.get_document(dataset_id, document_id)
  97. if not document:
  98. raise NotFound('Document not found.')
  99. if document.tenant_id != current_user.current_tenant_id:
  100. raise Forbidden('No permission.')
  101. return document
  102. def get_batch_documents(self, dataset_id: str, batch: str) -> List[Document]:
  103. dataset = DatasetService.get_dataset(dataset_id)
  104. if not dataset:
  105. raise NotFound('Dataset not found.')
  106. try:
  107. DatasetService.check_dataset_permission(dataset, current_user)
  108. except services.errors.account.NoPermissionError as e:
  109. raise Forbidden(str(e))
  110. documents = DocumentService.get_batch_documents(dataset_id, batch)
  111. if not documents:
  112. raise NotFound('Documents not found.')
  113. return documents
  114. class GetProcessRuleApi(Resource):
  115. @setup_required
  116. @login_required
  117. @account_initialization_required
  118. def get(self):
  119. req_data = request.args
  120. document_id = req_data.get('document_id')
  121. if document_id:
  122. # get the latest process rule
  123. document = Document.query.get_or_404(document_id)
  124. dataset = DatasetService.get_dataset(document.dataset_id)
  125. if not dataset:
  126. raise NotFound('Dataset not found.')
  127. try:
  128. DatasetService.check_dataset_permission(dataset, current_user)
  129. except services.errors.account.NoPermissionError as e:
  130. raise Forbidden(str(e))
  131. # get the latest process rule
  132. dataset_process_rule = db.session.query(DatasetProcessRule). \
  133. filter(DatasetProcessRule.dataset_id == document.dataset_id). \
  134. order_by(DatasetProcessRule.created_at.desc()). \
  135. limit(1). \
  136. one_or_none()
  137. mode = dataset_process_rule.mode
  138. rules = dataset_process_rule.rules_dict
  139. else:
  140. mode = DocumentService.DEFAULT_RULES['mode']
  141. rules = DocumentService.DEFAULT_RULES['rules']
  142. return {
  143. 'mode': mode,
  144. 'rules': rules
  145. }
  146. class DatasetDocumentListApi(Resource):
  147. @setup_required
  148. @login_required
  149. @account_initialization_required
  150. def get(self, dataset_id):
  151. dataset_id = str(dataset_id)
  152. page = request.args.get('page', default=1, type=int)
  153. limit = request.args.get('limit', default=20, type=int)
  154. search = request.args.get('keyword', default=None, type=str)
  155. sort = request.args.get('sort', default='-created_at', type=str)
  156. fetch = request.args.get('fetch', default=False, type=bool)
  157. dataset = DatasetService.get_dataset(dataset_id)
  158. if not dataset:
  159. raise NotFound('Dataset not found.')
  160. try:
  161. DatasetService.check_dataset_permission(dataset, current_user)
  162. except services.errors.account.NoPermissionError as e:
  163. raise Forbidden(str(e))
  164. query = Document.query.filter_by(
  165. dataset_id=str(dataset_id), tenant_id=current_user.current_tenant_id)
  166. if search:
  167. search = f'%{search}%'
  168. query = query.filter(Document.name.like(search))
  169. if sort.startswith('-'):
  170. sort_logic = desc
  171. sort = sort[1:]
  172. else:
  173. sort_logic = asc
  174. if sort == 'hit_count':
  175. sub_query = db.select(DocumentSegment.document_id,
  176. db.func.sum(DocumentSegment.hit_count).label("total_hit_count")) \
  177. .group_by(DocumentSegment.document_id) \
  178. .subquery()
  179. query = query.outerjoin(sub_query, sub_query.c.document_id == Document.id) \
  180. .order_by(sort_logic(db.func.coalesce(sub_query.c.total_hit_count, 0)))
  181. elif sort == 'created_at':
  182. query = query.order_by(sort_logic(Document.created_at))
  183. else:
  184. query = query.order_by(desc(Document.created_at))
  185. paginated_documents = query.paginate(
  186. page=page, per_page=limit, max_per_page=100, error_out=False)
  187. documents = paginated_documents.items
  188. if fetch:
  189. for document in documents:
  190. completed_segments = DocumentSegment.query.filter(DocumentSegment.completed_at.isnot(None),
  191. DocumentSegment.document_id == str(document.id),
  192. DocumentSegment.status != 're_segment').count()
  193. total_segments = DocumentSegment.query.filter(DocumentSegment.document_id == str(document.id),
  194. DocumentSegment.status != 're_segment').count()
  195. document.completed_segments = completed_segments
  196. document.total_segments = total_segments
  197. data = marshal(documents, document_with_segments_fields)
  198. else:
  199. data = marshal(documents, document_fields)
  200. response = {
  201. 'data': data,
  202. 'has_more': len(documents) == limit,
  203. 'limit': limit,
  204. 'total': paginated_documents.total,
  205. 'page': page
  206. }
  207. return response
  208. documents_and_batch_fields = {
  209. 'documents': fields.List(fields.Nested(document_fields)),
  210. 'batch': fields.String
  211. }
  212. @setup_required
  213. @login_required
  214. @account_initialization_required
  215. @marshal_with(documents_and_batch_fields)
  216. def post(self, dataset_id):
  217. dataset_id = str(dataset_id)
  218. dataset = DatasetService.get_dataset(dataset_id)
  219. if not dataset:
  220. raise NotFound('Dataset not found.')
  221. # The role of the current user in the ta table must be admin or owner
  222. if current_user.current_tenant.current_role not in ['admin', 'owner']:
  223. raise Forbidden()
  224. try:
  225. DatasetService.check_dataset_permission(dataset, current_user)
  226. except services.errors.account.NoPermissionError as e:
  227. raise Forbidden(str(e))
  228. parser = reqparse.RequestParser()
  229. parser.add_argument('indexing_technique', type=str, choices=Dataset.INDEXING_TECHNIQUE_LIST, nullable=False,
  230. location='json')
  231. parser.add_argument('data_source', type=dict, required=False, location='json')
  232. parser.add_argument('process_rule', type=dict, required=False, location='json')
  233. parser.add_argument('duplicate', type=bool, nullable=False, location='json')
  234. parser.add_argument('original_document_id', type=str, required=False, location='json')
  235. parser.add_argument('doc_form', type=str, default='text_model', required=False, nullable=False, location='json')
  236. parser.add_argument('doc_language', type=str, default='English', required=False, nullable=False,
  237. location='json')
  238. args = parser.parse_args()
  239. if not dataset.indexing_technique and not args['indexing_technique']:
  240. raise ValueError('indexing_technique is required.')
  241. # validate args
  242. DocumentService.document_create_args_validate(args)
  243. try:
  244. documents, batch = DocumentService.save_document_with_dataset_id(dataset, args, current_user)
  245. except ProviderTokenNotInitError as ex:
  246. raise ProviderNotInitializeError(ex.description)
  247. except QuotaExceededError:
  248. raise ProviderQuotaExceededError()
  249. except ModelCurrentlyNotSupportError:
  250. raise ProviderModelCurrentlyNotSupportError()
  251. return {
  252. 'documents': documents,
  253. 'batch': batch
  254. }
  255. class DatasetInitApi(Resource):
  256. dataset_and_document_fields = {
  257. 'dataset': fields.Nested(dataset_fields),
  258. 'documents': fields.List(fields.Nested(document_fields)),
  259. 'batch': fields.String
  260. }
  261. @setup_required
  262. @login_required
  263. @account_initialization_required
  264. @marshal_with(dataset_and_document_fields)
  265. def post(self):
  266. # The role of the current user in the ta table must be admin or owner
  267. if current_user.current_tenant.current_role not in ['admin', 'owner']:
  268. raise Forbidden()
  269. parser = reqparse.RequestParser()
  270. parser.add_argument('indexing_technique', type=str, choices=Dataset.INDEXING_TECHNIQUE_LIST, required=True,
  271. nullable=False, location='json')
  272. parser.add_argument('data_source', type=dict, required=True, nullable=True, location='json')
  273. parser.add_argument('process_rule', type=dict, required=True, nullable=True, location='json')
  274. parser.add_argument('doc_form', type=str, default='text_model', required=False, nullable=False, location='json')
  275. parser.add_argument('doc_language', type=str, default='English', required=False, nullable=False,
  276. location='json')
  277. args = parser.parse_args()
  278. if args['indexing_technique'] == 'high_quality':
  279. try:
  280. ModelFactory.get_embedding_model(
  281. tenant_id=current_user.current_tenant_id
  282. )
  283. except LLMBadRequestError:
  284. raise ProviderNotInitializeError(
  285. f"No Embedding Model available. Please configure a valid provider "
  286. f"in the Settings -> Model Provider.")
  287. except ProviderTokenNotInitError as ex:
  288. raise ProviderNotInitializeError(ex.description)
  289. # validate args
  290. DocumentService.document_create_args_validate(args)
  291. try:
  292. dataset, documents, batch = DocumentService.save_document_without_dataset_id(
  293. tenant_id=current_user.current_tenant_id,
  294. document_data=args,
  295. account=current_user
  296. )
  297. except ProviderTokenNotInitError as ex:
  298. raise ProviderNotInitializeError(ex.description)
  299. except QuotaExceededError:
  300. raise ProviderQuotaExceededError()
  301. except ModelCurrentlyNotSupportError:
  302. raise ProviderModelCurrentlyNotSupportError()
  303. response = {
  304. 'dataset': dataset,
  305. 'documents': documents,
  306. 'batch': batch
  307. }
  308. return response
  309. class DocumentIndexingEstimateApi(DocumentResource):
  310. @setup_required
  311. @login_required
  312. @account_initialization_required
  313. def get(self, dataset_id, document_id):
  314. dataset_id = str(dataset_id)
  315. document_id = str(document_id)
  316. document = self.get_document(dataset_id, document_id)
  317. if document.indexing_status in ['completed', 'error']:
  318. raise DocumentAlreadyFinishedError()
  319. data_process_rule = document.dataset_process_rule
  320. data_process_rule_dict = data_process_rule.to_dict()
  321. response = {
  322. "tokens": 0,
  323. "total_price": 0,
  324. "currency": "USD",
  325. "total_segments": 0,
  326. "preview": []
  327. }
  328. if document.data_source_type == 'upload_file':
  329. data_source_info = document.data_source_info_dict
  330. if data_source_info and 'upload_file_id' in data_source_info:
  331. file_id = data_source_info['upload_file_id']
  332. file = db.session.query(UploadFile).filter(
  333. UploadFile.tenant_id == document.tenant_id,
  334. UploadFile.id == file_id
  335. ).first()
  336. # raise error if file not found
  337. if not file:
  338. raise NotFound('File not found.')
  339. indexing_runner = IndexingRunner()
  340. try:
  341. response = indexing_runner.file_indexing_estimate(current_user.current_tenant_id, [file],
  342. data_process_rule_dict, None,
  343. 'English', dataset_id)
  344. except LLMBadRequestError:
  345. raise ProviderNotInitializeError(
  346. f"No Embedding Model available. Please configure a valid provider "
  347. f"in the Settings -> Model Provider.")
  348. except ProviderTokenNotInitError as ex:
  349. raise ProviderNotInitializeError(ex.description)
  350. return response
  351. class DocumentBatchIndexingEstimateApi(DocumentResource):
  352. @setup_required
  353. @login_required
  354. @account_initialization_required
  355. def get(self, dataset_id, batch):
  356. dataset_id = str(dataset_id)
  357. batch = str(batch)
  358. dataset = DatasetService.get_dataset(dataset_id)
  359. if dataset is None:
  360. raise NotFound("Dataset not found.")
  361. documents = self.get_batch_documents(dataset_id, batch)
  362. response = {
  363. "tokens": 0,
  364. "total_price": 0,
  365. "currency": "USD",
  366. "total_segments": 0,
  367. "preview": []
  368. }
  369. if not documents:
  370. return response
  371. data_process_rule = documents[0].dataset_process_rule
  372. data_process_rule_dict = data_process_rule.to_dict()
  373. info_list = []
  374. for document in documents:
  375. if document.indexing_status in ['completed', 'error']:
  376. raise DocumentAlreadyFinishedError()
  377. data_source_info = document.data_source_info_dict
  378. # format document files info
  379. if data_source_info and 'upload_file_id' in data_source_info:
  380. file_id = data_source_info['upload_file_id']
  381. info_list.append(file_id)
  382. # format document notion info
  383. elif data_source_info and 'notion_workspace_id' in data_source_info and 'notion_page_id' in data_source_info:
  384. pages = []
  385. page = {
  386. 'page_id': data_source_info['notion_page_id'],
  387. 'type': data_source_info['type']
  388. }
  389. pages.append(page)
  390. notion_info = {
  391. 'workspace_id': data_source_info['notion_workspace_id'],
  392. 'pages': pages
  393. }
  394. info_list.append(notion_info)
  395. if dataset.data_source_type == 'upload_file':
  396. file_details = db.session.query(UploadFile).filter(
  397. UploadFile.tenant_id == current_user.current_tenant_id,
  398. UploadFile.id in info_list
  399. ).all()
  400. if file_details is None:
  401. raise NotFound("File not found.")
  402. indexing_runner = IndexingRunner()
  403. try:
  404. response = indexing_runner.file_indexing_estimate(current_user.current_tenant_id, file_details,
  405. data_process_rule_dict, None,
  406. 'English', dataset_id)
  407. except LLMBadRequestError:
  408. raise ProviderNotInitializeError(
  409. f"No Embedding Model available. Please configure a valid provider "
  410. f"in the Settings -> Model Provider.")
  411. except ProviderTokenNotInitError as ex:
  412. raise ProviderNotInitializeError(ex.description)
  413. elif dataset.data_source_type == 'notion_import':
  414. indexing_runner = IndexingRunner()
  415. try:
  416. response = indexing_runner.notion_indexing_estimate(current_user.current_tenant_id,
  417. info_list,
  418. data_process_rule_dict,
  419. None, 'English', dataset_id)
  420. except LLMBadRequestError:
  421. raise ProviderNotInitializeError(
  422. f"No Embedding Model available. Please configure a valid provider "
  423. f"in the Settings -> Model Provider.")
  424. except ProviderTokenNotInitError as ex:
  425. raise ProviderNotInitializeError(ex.description)
  426. else:
  427. raise ValueError('Data source type not support')
  428. return response
  429. class DocumentBatchIndexingStatusApi(DocumentResource):
  430. document_status_fields = {
  431. 'id': fields.String,
  432. 'indexing_status': fields.String,
  433. 'processing_started_at': TimestampField,
  434. 'parsing_completed_at': TimestampField,
  435. 'cleaning_completed_at': TimestampField,
  436. 'splitting_completed_at': TimestampField,
  437. 'completed_at': TimestampField,
  438. 'paused_at': TimestampField,
  439. 'error': fields.String,
  440. 'stopped_at': TimestampField,
  441. 'completed_segments': fields.Integer,
  442. 'total_segments': fields.Integer,
  443. }
  444. document_status_fields_list = {
  445. 'data': fields.List(fields.Nested(document_status_fields))
  446. }
  447. @setup_required
  448. @login_required
  449. @account_initialization_required
  450. def get(self, dataset_id, batch):
  451. dataset_id = str(dataset_id)
  452. batch = str(batch)
  453. documents = self.get_batch_documents(dataset_id, batch)
  454. documents_status = []
  455. for document in documents:
  456. completed_segments = DocumentSegment.query.filter(DocumentSegment.completed_at.isnot(None),
  457. DocumentSegment.document_id == str(document.id),
  458. DocumentSegment.status != 're_segment').count()
  459. total_segments = DocumentSegment.query.filter(DocumentSegment.document_id == str(document.id),
  460. DocumentSegment.status != 're_segment').count()
  461. document.completed_segments = completed_segments
  462. document.total_segments = total_segments
  463. if document.is_paused:
  464. document.indexing_status = 'paused'
  465. documents_status.append(marshal(document, self.document_status_fields))
  466. data = {
  467. 'data': documents_status
  468. }
  469. return data
  470. class DocumentIndexingStatusApi(DocumentResource):
  471. document_status_fields = {
  472. 'id': fields.String,
  473. 'indexing_status': fields.String,
  474. 'processing_started_at': TimestampField,
  475. 'parsing_completed_at': TimestampField,
  476. 'cleaning_completed_at': TimestampField,
  477. 'splitting_completed_at': TimestampField,
  478. 'completed_at': TimestampField,
  479. 'paused_at': TimestampField,
  480. 'error': fields.String,
  481. 'stopped_at': TimestampField,
  482. 'completed_segments': fields.Integer,
  483. 'total_segments': fields.Integer,
  484. }
  485. @setup_required
  486. @login_required
  487. @account_initialization_required
  488. def get(self, dataset_id, document_id):
  489. dataset_id = str(dataset_id)
  490. document_id = str(document_id)
  491. document = self.get_document(dataset_id, document_id)
  492. completed_segments = DocumentSegment.query \
  493. .filter(DocumentSegment.completed_at.isnot(None),
  494. DocumentSegment.document_id == str(document_id),
  495. DocumentSegment.status != 're_segment') \
  496. .count()
  497. total_segments = DocumentSegment.query \
  498. .filter(DocumentSegment.document_id == str(document_id),
  499. DocumentSegment.status != 're_segment') \
  500. .count()
  501. document.completed_segments = completed_segments
  502. document.total_segments = total_segments
  503. if document.is_paused:
  504. document.indexing_status = 'paused'
  505. return marshal(document, self.document_status_fields)
  506. class DocumentDetailApi(DocumentResource):
  507. METADATA_CHOICES = {'all', 'only', 'without'}
  508. @setup_required
  509. @login_required
  510. @account_initialization_required
  511. def get(self, dataset_id, document_id):
  512. dataset_id = str(dataset_id)
  513. document_id = str(document_id)
  514. document = self.get_document(dataset_id, document_id)
  515. metadata = request.args.get('metadata', 'all')
  516. if metadata not in self.METADATA_CHOICES:
  517. raise InvalidMetadataError(f'Invalid metadata value: {metadata}')
  518. if metadata == 'only':
  519. response = {
  520. 'id': document.id,
  521. 'doc_type': document.doc_type,
  522. 'doc_metadata': document.doc_metadata
  523. }
  524. elif metadata == 'without':
  525. process_rules = DatasetService.get_process_rules(dataset_id)
  526. data_source_info = document.data_source_detail_dict
  527. response = {
  528. 'id': document.id,
  529. 'position': document.position,
  530. 'data_source_type': document.data_source_type,
  531. 'data_source_info': data_source_info,
  532. 'dataset_process_rule_id': document.dataset_process_rule_id,
  533. 'dataset_process_rule': process_rules,
  534. 'name': document.name,
  535. 'created_from': document.created_from,
  536. 'created_by': document.created_by,
  537. 'created_at': document.created_at.timestamp(),
  538. 'tokens': document.tokens,
  539. 'indexing_status': document.indexing_status,
  540. 'completed_at': int(document.completed_at.timestamp()) if document.completed_at else None,
  541. 'updated_at': int(document.updated_at.timestamp()) if document.updated_at else None,
  542. 'indexing_latency': document.indexing_latency,
  543. 'error': document.error,
  544. 'enabled': document.enabled,
  545. 'disabled_at': int(document.disabled_at.timestamp()) if document.disabled_at else None,
  546. 'disabled_by': document.disabled_by,
  547. 'archived': document.archived,
  548. 'segment_count': document.segment_count,
  549. 'average_segment_length': document.average_segment_length,
  550. 'hit_count': document.hit_count,
  551. 'display_status': document.display_status,
  552. 'doc_form': document.doc_form
  553. }
  554. else:
  555. process_rules = DatasetService.get_process_rules(dataset_id)
  556. data_source_info = document.data_source_detail_dict_()
  557. response = {
  558. 'id': document.id,
  559. 'position': document.position,
  560. 'data_source_type': document.data_source_type,
  561. 'data_source_info': data_source_info,
  562. 'dataset_process_rule_id': document.dataset_process_rule_id,
  563. 'dataset_process_rule': process_rules,
  564. 'name': document.name,
  565. 'created_from': document.created_from,
  566. 'created_by': document.created_by,
  567. 'created_at': document.created_at.timestamp(),
  568. 'tokens': document.tokens,
  569. 'indexing_status': document.indexing_status,
  570. 'completed_at': int(document.completed_at.timestamp()) if document.completed_at else None,
  571. 'updated_at': int(document.updated_at.timestamp()) if document.updated_at else None,
  572. 'indexing_latency': document.indexing_latency,
  573. 'error': document.error,
  574. 'enabled': document.enabled,
  575. 'disabled_at': int(document.disabled_at.timestamp()) if document.disabled_at else None,
  576. 'disabled_by': document.disabled_by,
  577. 'archived': document.archived,
  578. 'doc_type': document.doc_type,
  579. 'doc_metadata': document.doc_metadata,
  580. 'segment_count': document.segment_count,
  581. 'average_segment_length': document.average_segment_length,
  582. 'hit_count': document.hit_count,
  583. 'display_status': document.display_status,
  584. 'doc_form': document.doc_form
  585. }
  586. return response, 200
  587. class DocumentProcessingApi(DocumentResource):
  588. @setup_required
  589. @login_required
  590. @account_initialization_required
  591. def patch(self, dataset_id, document_id, action):
  592. dataset_id = str(dataset_id)
  593. document_id = str(document_id)
  594. document = self.get_document(dataset_id, document_id)
  595. # The role of the current user in the ta table must be admin or owner
  596. if current_user.current_tenant.current_role not in ['admin', 'owner']:
  597. raise Forbidden()
  598. if action == "pause":
  599. if document.indexing_status != "indexing":
  600. raise InvalidActionError('Document not in indexing state.')
  601. document.paused_by = current_user.id
  602. document.paused_at = datetime.utcnow()
  603. document.is_paused = True
  604. db.session.commit()
  605. elif action == "resume":
  606. if document.indexing_status not in ["paused", "error"]:
  607. raise InvalidActionError('Document not in paused or error state.')
  608. document.paused_by = None
  609. document.paused_at = None
  610. document.is_paused = False
  611. db.session.commit()
  612. else:
  613. raise InvalidActionError()
  614. return {'result': 'success'}, 200
  615. class DocumentDeleteApi(DocumentResource):
  616. @setup_required
  617. @login_required
  618. @account_initialization_required
  619. def delete(self, dataset_id, document_id):
  620. dataset_id = str(dataset_id)
  621. document_id = str(document_id)
  622. dataset = DatasetService.get_dataset(dataset_id)
  623. if dataset is None:
  624. raise NotFound("Dataset not found.")
  625. # check user's model setting
  626. DatasetService.check_dataset_model_setting(dataset)
  627. document = self.get_document(dataset_id, document_id)
  628. try:
  629. DocumentService.delete_document(document)
  630. except services.errors.document.DocumentIndexingError:
  631. raise DocumentIndexingError('Cannot delete document during indexing.')
  632. return {'result': 'success'}, 204
  633. class DocumentMetadataApi(DocumentResource):
  634. @setup_required
  635. @login_required
  636. @account_initialization_required
  637. def put(self, dataset_id, document_id):
  638. dataset_id = str(dataset_id)
  639. document_id = str(document_id)
  640. document = self.get_document(dataset_id, document_id)
  641. req_data = request.get_json()
  642. doc_type = req_data.get('doc_type')
  643. doc_metadata = req_data.get('doc_metadata')
  644. # The role of the current user in the ta table must be admin or owner
  645. if current_user.current_tenant.current_role not in ['admin', 'owner']:
  646. raise Forbidden()
  647. if doc_type is None or doc_metadata is None:
  648. raise ValueError('Both doc_type and doc_metadata must be provided.')
  649. if doc_type not in DocumentService.DOCUMENT_METADATA_SCHEMA:
  650. raise ValueError('Invalid doc_type.')
  651. if not isinstance(doc_metadata, dict):
  652. raise ValueError('doc_metadata must be a dictionary.')
  653. metadata_schema = DocumentService.DOCUMENT_METADATA_SCHEMA[doc_type]
  654. document.doc_metadata = {}
  655. if doc_type == 'others':
  656. document.doc_metadata = doc_metadata
  657. else:
  658. for key, value_type in metadata_schema.items():
  659. value = doc_metadata.get(key)
  660. if value is not None and isinstance(value, value_type):
  661. document.doc_metadata[key] = value
  662. document.doc_type = doc_type
  663. document.updated_at = datetime.utcnow()
  664. db.session.commit()
  665. return {'result': 'success', 'message': 'Document metadata updated.'}, 200
  666. class DocumentStatusApi(DocumentResource):
  667. @setup_required
  668. @login_required
  669. @account_initialization_required
  670. def patch(self, dataset_id, document_id, action):
  671. dataset_id = str(dataset_id)
  672. document_id = str(document_id)
  673. dataset = DatasetService.get_dataset(dataset_id)
  674. if dataset is None:
  675. raise NotFound("Dataset not found.")
  676. # check user's model setting
  677. DatasetService.check_dataset_model_setting(dataset)
  678. document = self.get_document(dataset_id, document_id)
  679. # The role of the current user in the ta table must be admin or owner
  680. if current_user.current_tenant.current_role not in ['admin', 'owner']:
  681. raise Forbidden()
  682. indexing_cache_key = 'document_{}_indexing'.format(document.id)
  683. cache_result = redis_client.get(indexing_cache_key)
  684. if cache_result is not None:
  685. raise InvalidActionError("Document is being indexed, please try again later")
  686. if action == "enable":
  687. if document.enabled:
  688. raise InvalidActionError('Document already enabled.')
  689. document.enabled = True
  690. document.disabled_at = None
  691. document.disabled_by = None
  692. document.updated_at = datetime.utcnow()
  693. db.session.commit()
  694. # Set cache to prevent indexing the same document multiple times
  695. redis_client.setex(indexing_cache_key, 600, 1)
  696. add_document_to_index_task.delay(document_id)
  697. return {'result': 'success'}, 200
  698. elif action == "disable":
  699. if not document.completed_at or document.indexing_status != 'completed':
  700. raise InvalidActionError('Document is not completed.')
  701. if not document.enabled:
  702. raise InvalidActionError('Document already disabled.')
  703. document.enabled = False
  704. document.disabled_at = datetime.utcnow()
  705. document.disabled_by = current_user.id
  706. document.updated_at = datetime.utcnow()
  707. db.session.commit()
  708. # Set cache to prevent indexing the same document multiple times
  709. redis_client.setex(indexing_cache_key, 600, 1)
  710. remove_document_from_index_task.delay(document_id)
  711. return {'result': 'success'}, 200
  712. elif action == "archive":
  713. if document.archived:
  714. raise InvalidActionError('Document already archived.')
  715. document.archived = True
  716. document.archived_at = datetime.utcnow()
  717. document.archived_by = current_user.id
  718. document.updated_at = datetime.utcnow()
  719. db.session.commit()
  720. if document.enabled:
  721. # Set cache to prevent indexing the same document multiple times
  722. redis_client.setex(indexing_cache_key, 600, 1)
  723. remove_document_from_index_task.delay(document_id)
  724. return {'result': 'success'}, 200
  725. elif action == "un_archive":
  726. if not document.archived:
  727. raise InvalidActionError('Document is not archived.')
  728. # check document limit
  729. if current_app.config['EDITION'] == 'CLOUD':
  730. documents_count = DocumentService.get_tenant_documents_count()
  731. total_count = documents_count + 1
  732. tenant_document_count = int(current_app.config['TENANT_DOCUMENT_COUNT'])
  733. if total_count > tenant_document_count:
  734. raise ValueError(f"All your documents have overed limit {tenant_document_count}.")
  735. document.archived = False
  736. document.archived_at = None
  737. document.archived_by = None
  738. document.updated_at = datetime.utcnow()
  739. db.session.commit()
  740. # Set cache to prevent indexing the same document multiple times
  741. redis_client.setex(indexing_cache_key, 600, 1)
  742. add_document_to_index_task.delay(document_id)
  743. return {'result': 'success'}, 200
  744. else:
  745. raise InvalidActionError()
  746. class DocumentPauseApi(DocumentResource):
  747. @setup_required
  748. @login_required
  749. @account_initialization_required
  750. def patch(self, dataset_id, document_id):
  751. """pause document."""
  752. dataset_id = str(dataset_id)
  753. document_id = str(document_id)
  754. dataset = DatasetService.get_dataset(dataset_id)
  755. if not dataset:
  756. raise NotFound('Dataset not found.')
  757. document = DocumentService.get_document(dataset.id, document_id)
  758. # 404 if document not found
  759. if document is None:
  760. raise NotFound("Document Not Exists.")
  761. # 403 if document is archived
  762. if DocumentService.check_archived(document):
  763. raise ArchivedDocumentImmutableError()
  764. try:
  765. # pause document
  766. DocumentService.pause_document(document)
  767. except services.errors.document.DocumentIndexingError:
  768. raise DocumentIndexingError('Cannot pause completed document.')
  769. return {'result': 'success'}, 204
  770. class DocumentRecoverApi(DocumentResource):
  771. @setup_required
  772. @login_required
  773. @account_initialization_required
  774. def patch(self, dataset_id, document_id):
  775. """recover document."""
  776. dataset_id = str(dataset_id)
  777. document_id = str(document_id)
  778. dataset = DatasetService.get_dataset(dataset_id)
  779. if not dataset:
  780. raise NotFound('Dataset not found.')
  781. document = DocumentService.get_document(dataset.id, document_id)
  782. # 404 if document not found
  783. if document is None:
  784. raise NotFound("Document Not Exists.")
  785. # 403 if document is archived
  786. if DocumentService.check_archived(document):
  787. raise ArchivedDocumentImmutableError()
  788. try:
  789. # pause document
  790. DocumentService.recover_document(document)
  791. except services.errors.document.DocumentIndexingError:
  792. raise DocumentIndexingError('Document is not in paused status.')
  793. return {'result': 'success'}, 204
  794. class DocumentLimitApi(DocumentResource):
  795. @setup_required
  796. @login_required
  797. @account_initialization_required
  798. def get(self):
  799. """get document limit"""
  800. documents_count = DocumentService.get_tenant_documents_count()
  801. tenant_document_count = int(current_app.config['TENANT_DOCUMENT_COUNT'])
  802. return {
  803. 'documents_count': documents_count,
  804. 'documents_limit': tenant_document_count
  805. }, 200
  806. api.add_resource(GetProcessRuleApi, '/datasets/process-rule')
  807. api.add_resource(DatasetDocumentListApi,
  808. '/datasets/<uuid:dataset_id>/documents')
  809. api.add_resource(DatasetInitApi,
  810. '/datasets/init')
  811. api.add_resource(DocumentIndexingEstimateApi,
  812. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/indexing-estimate')
  813. api.add_resource(DocumentBatchIndexingEstimateApi,
  814. '/datasets/<uuid:dataset_id>/batch/<string:batch>/indexing-estimate')
  815. api.add_resource(DocumentBatchIndexingStatusApi,
  816. '/datasets/<uuid:dataset_id>/batch/<string:batch>/indexing-status')
  817. api.add_resource(DocumentIndexingStatusApi,
  818. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/indexing-status')
  819. api.add_resource(DocumentDetailApi,
  820. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>')
  821. api.add_resource(DocumentProcessingApi,
  822. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/processing/<string:action>')
  823. api.add_resource(DocumentDeleteApi,
  824. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>')
  825. api.add_resource(DocumentMetadataApi,
  826. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/metadata')
  827. api.add_resource(DocumentStatusApi,
  828. '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/status/<string:action>')
  829. api.add_resource(DocumentPauseApi, '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/processing/pause')
  830. api.add_resource(DocumentRecoverApi, '/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/processing/resume')
  831. api.add_resource(DocumentLimitApi, '/datasets/limit')