datasets_document.py 47 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121
  1. import logging
  2. from argparse import ArgumentTypeError
  3. from datetime import UTC, datetime
  4. from typing import cast
  5. from flask import request
  6. from flask_login import current_user # type: ignore
  7. from flask_restful import Resource, fields, marshal, marshal_with, reqparse # type: ignore
  8. from sqlalchemy import asc, desc
  9. from werkzeug.exceptions import Forbidden, NotFound
  10. import services
  11. from controllers.console import api
  12. from controllers.console.app.error import (
  13. ProviderModelCurrentlyNotSupportError,
  14. ProviderNotInitializeError,
  15. ProviderQuotaExceededError,
  16. )
  17. from controllers.console.datasets.error import (
  18. ArchivedDocumentImmutableError,
  19. DocumentAlreadyFinishedError,
  20. DocumentIndexingError,
  21. IndexingEstimateError,
  22. InvalidActionError,
  23. InvalidMetadataError,
  24. )
  25. from controllers.console.wraps import (
  26. account_initialization_required,
  27. cloud_edition_billing_rate_limit_check,
  28. cloud_edition_billing_resource_check,
  29. setup_required,
  30. )
  31. from core.errors.error import (
  32. LLMBadRequestError,
  33. ModelCurrentlyNotSupportError,
  34. ProviderTokenNotInitError,
  35. QuotaExceededError,
  36. )
  37. from core.indexing_runner import IndexingRunner
  38. from core.model_manager import ModelManager
  39. from core.model_runtime.entities.model_entities import ModelType
  40. from core.model_runtime.errors.invoke import InvokeAuthorizationError
  41. from core.plugin.manager.exc import PluginDaemonClientSideError
  42. from core.rag.extractor.entity.extract_setting import ExtractSetting
  43. from extensions.ext_database import db
  44. from extensions.ext_redis import redis_client
  45. from fields.document_fields import (
  46. dataset_and_document_fields,
  47. document_fields,
  48. document_status_fields,
  49. document_with_segments_fields,
  50. )
  51. from libs.login import login_required
  52. from models import Dataset, DatasetProcessRule, Document, DocumentSegment, UploadFile
  53. from models.account import TenantAccountRole
  54. from services.account_service import AccountService
  55. from services.dataset_service import DatasetService, DocumentService
  56. from services.entities.knowledge_entities.knowledge_entities import KnowledgeConfig
  57. from tasks.add_document_to_index_task import add_document_to_index_task
  58. from tasks.remove_document_from_index_task import remove_document_from_index_task
  59. class DocumentResource(Resource):
  60. def get_document(self, dataset_id: str, document_id: str) -> Document:
  61. dataset = DatasetService.get_dataset(dataset_id)
  62. if not dataset:
  63. raise NotFound("Dataset not found.")
  64. try:
  65. DatasetService.check_dataset_permission(dataset, current_user)
  66. except services.errors.account.NoPermissionError as e:
  67. raise Forbidden(str(e))
  68. document = DocumentService.get_document(dataset_id, document_id)
  69. if not document:
  70. raise NotFound("Document not found.")
  71. if document.tenant_id != current_user.current_tenant_id:
  72. raise Forbidden("No permission.")
  73. return document
  74. def get_batch_documents(self, dataset_id: str, batch: str) -> list[Document]:
  75. dataset = DatasetService.get_dataset(dataset_id)
  76. if not dataset:
  77. raise NotFound("Dataset not found.")
  78. try:
  79. DatasetService.check_dataset_permission(dataset, current_user)
  80. except services.errors.account.NoPermissionError as e:
  81. raise Forbidden(str(e))
  82. documents = DocumentService.get_batch_documents(dataset_id, batch)
  83. if not documents:
  84. raise NotFound("Documents not found.")
  85. return documents
  86. class GetProcessRuleApi(Resource):
  87. @setup_required
  88. @login_required
  89. @account_initialization_required
  90. def get(self):
  91. req_data = request.args
  92. document_id = req_data.get("document_id")
  93. # get default rules
  94. mode = DocumentService.DEFAULT_RULES["mode"]
  95. rules = DocumentService.DEFAULT_RULES["rules"]
  96. limits = DocumentService.DEFAULT_RULES["limits"]
  97. if document_id:
  98. # get the latest process rule
  99. document = Document.query.get_or_404(document_id)
  100. dataset = DatasetService.get_dataset(document.dataset_id)
  101. if not dataset:
  102. raise NotFound("Dataset not found.")
  103. try:
  104. DatasetService.check_dataset_permission(dataset, current_user)
  105. except services.errors.account.NoPermissionError as e:
  106. raise Forbidden(str(e))
  107. # get the latest process rule
  108. dataset_process_rule = (
  109. db.session.query(DatasetProcessRule)
  110. .filter(DatasetProcessRule.dataset_id == document.dataset_id)
  111. .order_by(DatasetProcessRule.created_at.desc())
  112. .limit(1)
  113. .one_or_none()
  114. )
  115. if dataset_process_rule:
  116. mode = dataset_process_rule.mode
  117. rules = dataset_process_rule.rules_dict
  118. return {"mode": mode, "rules": rules, "limits": limits}
  119. class DatasetDocumentListApi(Resource):
  120. @setup_required
  121. @login_required
  122. @account_initialization_required
  123. def get(self, dataset_id):
  124. dataset_id = str(dataset_id)
  125. page = request.args.get("page", default=1, type=int)
  126. limit = request.args.get("limit", default=20, type=int)
  127. search = request.args.get("keyword", default=None, type=str)
  128. sort = request.args.get("sort", default="-created_at", type=str)
  129. # "yes", "true", "t", "y", "1" convert to True, while others convert to False.
  130. try:
  131. fetch_val = request.args.get("fetch", default="false")
  132. if isinstance(fetch_val, bool):
  133. fetch = fetch_val
  134. else:
  135. if fetch_val.lower() in ("yes", "true", "t", "y", "1"):
  136. fetch = True
  137. elif fetch_val.lower() in ("no", "false", "f", "n", "0"):
  138. fetch = False
  139. else:
  140. raise ArgumentTypeError(
  141. f"Truthy value expected: got {fetch_val} but expected one of yes/no, true/false, t/f, y/n, 1/0 "
  142. f"(case insensitive)."
  143. )
  144. except (ArgumentTypeError, ValueError, Exception):
  145. fetch = False
  146. dataset = DatasetService.get_dataset(dataset_id)
  147. if not dataset:
  148. raise NotFound("Dataset not found.")
  149. try:
  150. DatasetService.check_dataset_permission(dataset, current_user)
  151. except services.errors.account.NoPermissionError as e:
  152. raise Forbidden(str(e))
  153. query = Document.query.filter_by(dataset_id=str(dataset_id), tenant_id=current_user.current_tenant_id)
  154. if search:
  155. search = f"%{search}%"
  156. query = query.filter(Document.name.like(search))
  157. if sort.startswith("-"):
  158. sort_logic = desc
  159. sort = sort[1:]
  160. else:
  161. sort_logic = asc
  162. if sort == "hit_count":
  163. sub_query = (
  164. db.select(DocumentSegment.document_id, db.func.sum(DocumentSegment.hit_count).label("total_hit_count"))
  165. .group_by(DocumentSegment.document_id)
  166. .subquery()
  167. )
  168. query = query.outerjoin(sub_query, sub_query.c.document_id == Document.id).order_by(
  169. sort_logic(db.func.coalesce(sub_query.c.total_hit_count, 0)),
  170. sort_logic(Document.position),
  171. )
  172. elif sort == "created_at":
  173. query = query.order_by(
  174. sort_logic(Document.created_at),
  175. sort_logic(Document.position),
  176. )
  177. else:
  178. query = query.order_by(
  179. desc(Document.created_at),
  180. desc(Document.position),
  181. )
  182. paginated_documents = query.paginate(page=page, per_page=limit, max_per_page=100, error_out=False)
  183. documents = paginated_documents.items
  184. if fetch:
  185. for document in documents:
  186. completed_segments = DocumentSegment.query.filter(
  187. DocumentSegment.completed_at.isnot(None),
  188. DocumentSegment.document_id == str(document.id),
  189. DocumentSegment.status != "re_segment",
  190. ).count()
  191. total_segments = DocumentSegment.query.filter(
  192. DocumentSegment.document_id == str(document.id), DocumentSegment.status != "re_segment"
  193. ).count()
  194. document.completed_segments = completed_segments
  195. document.total_segments = total_segments
  196. if document.check_by is not None:
  197. check_account = AccountService.get_user_through_id(document.check_by)
  198. document.check_by = check_account.name
  199. if document.enable_applicant is not None:
  200. applicant_account = (AccountService.get_user_through_id(document.enable_applicant),)
  201. document.enable_applicant = applicant_account.name
  202. data = marshal(documents, document_with_segments_fields)
  203. else:
  204. for document in documents:
  205. if document.check_by is not None:
  206. check_account = AccountService.get_user_through_id(document.check_by)
  207. document.check_by = check_account.name
  208. if document.enable_applicant is not None:
  209. applicant_account = AccountService.get_user_through_id(document.enable_applicant)
  210. document.enable_applicant = applicant_account.name
  211. data = marshal(documents, document_fields)
  212. response = {
  213. "data": data,
  214. "has_more": len(documents) == limit,
  215. "limit": limit,
  216. "total": paginated_documents.total,
  217. "page": page,
  218. }
  219. return response
  220. documents_and_batch_fields = {"documents": fields.List(fields.Nested(document_fields)), "batch": fields.String}
  221. @setup_required
  222. @login_required
  223. @account_initialization_required
  224. @marshal_with(documents_and_batch_fields)
  225. @cloud_edition_billing_resource_check("vector_space")
  226. @cloud_edition_billing_rate_limit_check("knowledge")
  227. def post(self, dataset_id):
  228. dataset_id = str(dataset_id)
  229. dataset = DatasetService.get_dataset(dataset_id)
  230. if not dataset:
  231. raise NotFound("Dataset not found.")
  232. # The role of the current user in the ta table must be admin, owner, or editor
  233. if not current_user.is_dataset_editor:
  234. raise Forbidden()
  235. try:
  236. DatasetService.check_dataset_permission(dataset, current_user)
  237. except services.errors.account.NoPermissionError as e:
  238. raise Forbidden(str(e))
  239. parser = reqparse.RequestParser()
  240. parser.add_argument(
  241. "indexing_technique", type=str, choices=Dataset.INDEXING_TECHNIQUE_LIST, nullable=False, location="json"
  242. )
  243. parser.add_argument("data_source", type=dict, required=False, location="json")
  244. parser.add_argument("process_rule", type=dict, required=False, location="json")
  245. parser.add_argument("duplicate", type=bool, default=True, nullable=False, location="json")
  246. parser.add_argument("original_document_id", type=str, required=False, location="json")
  247. parser.add_argument("doc_form", type=str, default="text_model", required=False, nullable=False, location="json")
  248. parser.add_argument("retrieval_model", type=dict, required=False, nullable=False, location="json")
  249. parser.add_argument("embedding_model", type=str, required=False, nullable=True, location="json")
  250. parser.add_argument("embedding_model_provider", type=str, required=False, nullable=True, location="json")
  251. parser.add_argument(
  252. "doc_language", type=str, default="English", required=False, nullable=False, location="json"
  253. )
  254. args = parser.parse_args()
  255. knowledge_config = KnowledgeConfig(**args)
  256. if not dataset.indexing_technique and not knowledge_config.indexing_technique:
  257. raise ValueError("indexing_technique is required.")
  258. # validate args
  259. DocumentService.document_create_args_validate(knowledge_config)
  260. try:
  261. documents, batch = DocumentService.save_document_with_dataset_id(dataset, knowledge_config, current_user)
  262. except ProviderTokenNotInitError as ex:
  263. raise ProviderNotInitializeError(ex.description)
  264. except QuotaExceededError:
  265. raise ProviderQuotaExceededError()
  266. except ModelCurrentlyNotSupportError:
  267. raise ProviderModelCurrentlyNotSupportError()
  268. return {"documents": documents, "batch": batch}
  269. @setup_required
  270. @login_required
  271. @account_initialization_required
  272. @cloud_edition_billing_rate_limit_check("knowledge")
  273. def delete(self, dataset_id):
  274. dataset_id = str(dataset_id)
  275. dataset = DatasetService.get_dataset(dataset_id)
  276. if dataset is None:
  277. raise NotFound("Dataset not found.")
  278. # check user's model setting
  279. DatasetService.check_dataset_model_setting(dataset)
  280. try:
  281. document_ids = request.args.getlist("document_id")
  282. DocumentService.delete_documents(dataset, document_ids)
  283. except services.errors.document.DocumentIndexingError:
  284. raise DocumentIndexingError("Cannot delete document during indexing.")
  285. return {"result": "success"}, 204
  286. class DatasetInitApi(Resource):
  287. @setup_required
  288. @login_required
  289. @account_initialization_required
  290. @marshal_with(dataset_and_document_fields)
  291. @cloud_edition_billing_resource_check("vector_space")
  292. @cloud_edition_billing_rate_limit_check("knowledge")
  293. def post(self):
  294. # The role of the current user in the ta table must be admin, owner, dataset_operator, or editor
  295. if not current_user.is_dataset_editor:
  296. raise Forbidden()
  297. parser = reqparse.RequestParser()
  298. parser.add_argument(
  299. "indexing_technique",
  300. type=str,
  301. choices=Dataset.INDEXING_TECHNIQUE_LIST,
  302. required=True,
  303. nullable=False,
  304. location="json",
  305. )
  306. parser.add_argument("data_source", type=dict, required=True, nullable=True, location="json")
  307. parser.add_argument("process_rule", type=dict, required=True, nullable=True, location="json")
  308. parser.add_argument("doc_form", type=str, default="text_model", required=False, nullable=False, location="json")
  309. parser.add_argument(
  310. "doc_language", type=str, default="English", required=False, nullable=False, location="json"
  311. )
  312. parser.add_argument("retrieval_model", type=dict, required=False, nullable=False, location="json")
  313. parser.add_argument("embedding_model", type=str, required=False, nullable=True, location="json")
  314. parser.add_argument("embedding_model_provider", type=str, required=False, nullable=True, location="json")
  315. args = parser.parse_args()
  316. # The role of the current user in the ta table must be admin, owner, or editor, or dataset_operator
  317. if not current_user.is_dataset_editor:
  318. raise Forbidden()
  319. knowledge_config = KnowledgeConfig(**args)
  320. if knowledge_config.indexing_technique == "high_quality":
  321. if knowledge_config.embedding_model is None or knowledge_config.embedding_model_provider is None:
  322. raise ValueError("embedding model and embedding model provider are required for high quality indexing.")
  323. try:
  324. model_manager = ModelManager()
  325. model_manager.get_model_instance(
  326. tenant_id=current_user.current_tenant_id,
  327. provider=args["embedding_model_provider"],
  328. model_type=ModelType.TEXT_EMBEDDING,
  329. model=args["embedding_model"],
  330. )
  331. except InvokeAuthorizationError:
  332. raise ProviderNotInitializeError(
  333. "No Embedding Model available. Please configure a valid provider in the Settings -> Model Provider."
  334. )
  335. except ProviderTokenNotInitError as ex:
  336. raise ProviderNotInitializeError(ex.description)
  337. # validate args
  338. DocumentService.document_create_args_validate(knowledge_config)
  339. try:
  340. dataset, documents, batch = DocumentService.save_document_without_dataset_id(
  341. tenant_id=current_user.current_tenant_id, knowledge_config=knowledge_config, account=current_user
  342. )
  343. except ProviderTokenNotInitError as ex:
  344. raise ProviderNotInitializeError(ex.description)
  345. except QuotaExceededError:
  346. raise ProviderQuotaExceededError()
  347. except ModelCurrentlyNotSupportError:
  348. raise ProviderModelCurrentlyNotSupportError()
  349. response = {"dataset": dataset, "documents": documents, "batch": batch}
  350. return response
  351. class DocumentIndexingEstimateApi(DocumentResource):
  352. @setup_required
  353. @login_required
  354. @account_initialization_required
  355. def get(self, dataset_id, document_id):
  356. dataset_id = str(dataset_id)
  357. document_id = str(document_id)
  358. document = self.get_document(dataset_id, document_id)
  359. if document.indexing_status in {"completed", "error"}:
  360. raise DocumentAlreadyFinishedError()
  361. data_process_rule = document.dataset_process_rule
  362. data_process_rule_dict = data_process_rule.to_dict()
  363. response = {"tokens": 0, "total_price": 0, "currency": "USD", "total_segments": 0, "preview": []}
  364. if document.data_source_type == "upload_file":
  365. data_source_info = document.data_source_info_dict
  366. if data_source_info and "upload_file_id" in data_source_info:
  367. file_id = data_source_info["upload_file_id"]
  368. file = (
  369. db.session.query(UploadFile)
  370. .filter(UploadFile.tenant_id == document.tenant_id, UploadFile.id == file_id)
  371. .first()
  372. )
  373. # raise error if file not found
  374. if not file:
  375. raise NotFound("File not found.")
  376. extract_setting = ExtractSetting(
  377. datasource_type="upload_file", upload_file=file, document_model=document.doc_form
  378. )
  379. indexing_runner = IndexingRunner()
  380. try:
  381. estimate_response = indexing_runner.indexing_estimate(
  382. current_user.current_tenant_id,
  383. [extract_setting],
  384. data_process_rule_dict,
  385. document.doc_form,
  386. "English",
  387. dataset_id,
  388. )
  389. return estimate_response.model_dump(), 200
  390. except LLMBadRequestError:
  391. raise ProviderNotInitializeError(
  392. "No Embedding Model available. Please configure a valid provider "
  393. "in the Settings -> Model Provider."
  394. )
  395. except ProviderTokenNotInitError as ex:
  396. raise ProviderNotInitializeError(ex.description)
  397. except PluginDaemonClientSideError as ex:
  398. raise ProviderNotInitializeError(ex.description)
  399. except Exception as e:
  400. raise IndexingEstimateError(str(e))
  401. return response, 200
  402. class DocumentBatchIndexingEstimateApi(DocumentResource):
  403. @setup_required
  404. @login_required
  405. @account_initialization_required
  406. def get(self, dataset_id, batch):
  407. dataset_id = str(dataset_id)
  408. batch = str(batch)
  409. documents = self.get_batch_documents(dataset_id, batch)
  410. if not documents:
  411. return {"tokens": 0, "total_price": 0, "currency": "USD", "total_segments": 0, "preview": []}, 200
  412. data_process_rule = documents[0].dataset_process_rule
  413. data_process_rule_dict = data_process_rule.to_dict()
  414. info_list = []
  415. extract_settings = []
  416. for document in documents:
  417. if document.indexing_status in {"completed", "error"}:
  418. raise DocumentAlreadyFinishedError()
  419. data_source_info = document.data_source_info_dict
  420. # format document files info
  421. if data_source_info and "upload_file_id" in data_source_info:
  422. file_id = data_source_info["upload_file_id"]
  423. info_list.append(file_id)
  424. # format document notion info
  425. elif (
  426. data_source_info and "notion_workspace_id" in data_source_info and "notion_page_id" in data_source_info
  427. ):
  428. pages = []
  429. page = {"page_id": data_source_info["notion_page_id"], "type": data_source_info["type"]}
  430. pages.append(page)
  431. notion_info = {"workspace_id": data_source_info["notion_workspace_id"], "pages": pages}
  432. info_list.append(notion_info)
  433. if document.data_source_type == "upload_file":
  434. file_id = data_source_info["upload_file_id"]
  435. file_detail = (
  436. db.session.query(UploadFile)
  437. .filter(UploadFile.tenant_id == current_user.current_tenant_id, UploadFile.id == file_id)
  438. .first()
  439. )
  440. if file_detail is None:
  441. raise NotFound("File not found.")
  442. extract_setting = ExtractSetting(
  443. datasource_type="upload_file", upload_file=file_detail, document_model=document.doc_form
  444. )
  445. extract_settings.append(extract_setting)
  446. elif document.data_source_type == "notion_import":
  447. extract_setting = ExtractSetting(
  448. datasource_type="notion_import",
  449. notion_info={
  450. "notion_workspace_id": data_source_info["notion_workspace_id"],
  451. "notion_obj_id": data_source_info["notion_page_id"],
  452. "notion_page_type": data_source_info["type"],
  453. "tenant_id": current_user.current_tenant_id,
  454. },
  455. document_model=document.doc_form,
  456. )
  457. extract_settings.append(extract_setting)
  458. elif document.data_source_type == "website_crawl":
  459. extract_setting = ExtractSetting(
  460. datasource_type="website_crawl",
  461. website_info={
  462. "provider": data_source_info["provider"],
  463. "job_id": data_source_info["job_id"],
  464. "url": data_source_info["url"],
  465. "tenant_id": current_user.current_tenant_id,
  466. "mode": data_source_info["mode"],
  467. "only_main_content": data_source_info["only_main_content"],
  468. },
  469. document_model=document.doc_form,
  470. )
  471. extract_settings.append(extract_setting)
  472. else:
  473. raise ValueError("Data source type not support")
  474. indexing_runner = IndexingRunner()
  475. try:
  476. response = indexing_runner.indexing_estimate(
  477. current_user.current_tenant_id,
  478. extract_settings,
  479. data_process_rule_dict,
  480. document.doc_form,
  481. "English",
  482. dataset_id,
  483. )
  484. return response.model_dump(), 200
  485. except LLMBadRequestError:
  486. raise ProviderNotInitializeError(
  487. "No Embedding Model available. Please configure a valid provider in the Settings -> Model Provider."
  488. )
  489. except ProviderTokenNotInitError as ex:
  490. raise ProviderNotInitializeError(ex.description)
  491. except PluginDaemonClientSideError as ex:
  492. raise ProviderNotInitializeError(ex.description)
  493. except Exception as e:
  494. raise IndexingEstimateError(str(e))
  495. class DocumentBatchIndexingStatusApi(DocumentResource):
  496. @setup_required
  497. @login_required
  498. @account_initialization_required
  499. def get(self, dataset_id, batch):
  500. dataset_id = str(dataset_id)
  501. batch = str(batch)
  502. documents = self.get_batch_documents(dataset_id, batch)
  503. documents_status = []
  504. for document in documents:
  505. completed_segments = DocumentSegment.query.filter(
  506. DocumentSegment.completed_at.isnot(None),
  507. DocumentSegment.document_id == str(document.id),
  508. DocumentSegment.status != "re_segment",
  509. ).count()
  510. total_segments = DocumentSegment.query.filter(
  511. DocumentSegment.document_id == str(document.id), DocumentSegment.status != "re_segment"
  512. ).count()
  513. document.completed_segments = completed_segments
  514. document.total_segments = total_segments
  515. if document.is_paused:
  516. document.indexing_status = "paused"
  517. documents_status.append(marshal(document, document_status_fields))
  518. data = {"data": documents_status}
  519. return data
  520. class DocumentIndexingStatusApi(DocumentResource):
  521. @setup_required
  522. @login_required
  523. @account_initialization_required
  524. def get(self, dataset_id, document_id):
  525. dataset_id = str(dataset_id)
  526. document_id = str(document_id)
  527. document = self.get_document(dataset_id, document_id)
  528. completed_segments = DocumentSegment.query.filter(
  529. DocumentSegment.completed_at.isnot(None),
  530. DocumentSegment.document_id == str(document_id),
  531. DocumentSegment.status != "re_segment",
  532. ).count()
  533. total_segments = DocumentSegment.query.filter(
  534. DocumentSegment.document_id == str(document_id), DocumentSegment.status != "re_segment"
  535. ).count()
  536. document.completed_segments = completed_segments
  537. document.total_segments = total_segments
  538. if document.is_paused:
  539. document.indexing_status = "paused"
  540. return marshal(document, document_status_fields)
  541. class DocumentDetailApi(DocumentResource):
  542. METADATA_CHOICES = {"all", "only", "without"}
  543. @setup_required
  544. @login_required
  545. @account_initialization_required
  546. def get(self, dataset_id, document_id):
  547. dataset_id = str(dataset_id)
  548. document_id = str(document_id)
  549. document = self.get_document(dataset_id, document_id)
  550. metadata = request.args.get("metadata", "all")
  551. if metadata not in self.METADATA_CHOICES:
  552. raise InvalidMetadataError(f"Invalid metadata value: {metadata}")
  553. if metadata == "only":
  554. response = {"id": document.id, "doc_type": document.doc_type, "doc_metadata": document.doc_metadata_details}
  555. elif metadata == "without":
  556. dataset_process_rules = DatasetService.get_process_rules(dataset_id)
  557. document_process_rules = document.dataset_process_rule.to_dict()
  558. data_source_info = document.data_source_detail_dict
  559. response = {
  560. "id": document.id,
  561. "position": document.position,
  562. "data_source_type": document.data_source_type,
  563. "data_source_info": data_source_info,
  564. "dataset_process_rule_id": document.dataset_process_rule_id,
  565. "dataset_process_rule": dataset_process_rules,
  566. "document_process_rule": document_process_rules,
  567. "name": document.name,
  568. "created_from": document.created_from,
  569. "created_by": document.created_by,
  570. "created_at": document.created_at.timestamp(),
  571. "tokens": document.tokens,
  572. "indexing_status": document.indexing_status,
  573. "completed_at": int(document.completed_at.timestamp()) if document.completed_at else None,
  574. "updated_at": int(document.updated_at.timestamp()) if document.updated_at else None,
  575. "indexing_latency": document.indexing_latency,
  576. "error": document.error,
  577. "enabled": document.enabled,
  578. "disabled_at": int(document.disabled_at.timestamp()) if document.disabled_at else None,
  579. "disabled_by": document.disabled_by,
  580. "archived": document.archived,
  581. "segment_count": document.segment_count,
  582. "average_segment_length": document.average_segment_length,
  583. "hit_count": document.hit_count,
  584. "display_status": document.display_status,
  585. "doc_form": document.doc_form,
  586. "doc_language": document.doc_language,
  587. "check_status": document.check_status,
  588. "check_at": document.check_at,
  589. "disable_application": document.disable_applicant,
  590. "enable_application": document.enable_applicant,
  591. }
  592. else:
  593. dataset_process_rules = DatasetService.get_process_rules(dataset_id)
  594. document_process_rules = document.dataset_process_rule.to_dict()
  595. data_source_info = document.data_source_detail_dict
  596. response = {
  597. "id": document.id,
  598. "position": document.position,
  599. "data_source_type": document.data_source_type,
  600. "data_source_info": data_source_info,
  601. "dataset_process_rule_id": document.dataset_process_rule_id,
  602. "dataset_process_rule": dataset_process_rules,
  603. "document_process_rule": document_process_rules,
  604. "name": document.name,
  605. "created_from": document.created_from,
  606. "created_by": document.created_by,
  607. "created_at": document.created_at.timestamp(),
  608. "tokens": document.tokens,
  609. "indexing_status": document.indexing_status,
  610. "completed_at": int(document.completed_at.timestamp()) if document.completed_at else None,
  611. "updated_at": int(document.updated_at.timestamp()) if document.updated_at else None,
  612. "indexing_latency": document.indexing_latency,
  613. "error": document.error,
  614. "enabled": document.enabled,
  615. "disabled_at": int(document.disabled_at.timestamp()) if document.disabled_at else None,
  616. "disabled_by": document.disabled_by,
  617. "archived": document.archived,
  618. "doc_type": document.doc_type,
  619. "doc_metadata": document.doc_metadata_details,
  620. "segment_count": document.segment_count,
  621. "average_segment_length": document.average_segment_length,
  622. "hit_count": document.hit_count,
  623. "display_status": document.display_status,
  624. "doc_form": document.doc_form,
  625. "doc_language": document.doc_language,
  626. "check_status": document.check_status,
  627. "check_at": document.check_at,
  628. "disable_application": document.disable_applicant,
  629. "enable_application": document.enable_applicant,
  630. }
  631. return response, 200
  632. class DocumentProcessingApi(DocumentResource):
  633. @setup_required
  634. @login_required
  635. @account_initialization_required
  636. @cloud_edition_billing_rate_limit_check("knowledge")
  637. def patch(self, dataset_id, document_id, action):
  638. dataset_id = str(dataset_id)
  639. document_id = str(document_id)
  640. document = self.get_document(dataset_id, document_id)
  641. # The role of the current user in the ta table must be admin, owner, dataset_operator, or editor
  642. if not current_user.is_dataset_editor:
  643. raise Forbidden()
  644. if action == "pause":
  645. if document.indexing_status != "indexing":
  646. raise InvalidActionError("Document not in indexing state.")
  647. document.paused_by = current_user.id
  648. document.paused_at = datetime.now(UTC).replace(tzinfo=None)
  649. document.is_paused = True
  650. db.session.commit()
  651. elif action == "resume":
  652. if document.indexing_status not in {"paused", "error"}:
  653. raise InvalidActionError("Document not in paused or error state.")
  654. document.paused_by = None
  655. document.paused_at = None
  656. document.is_paused = False
  657. db.session.commit()
  658. else:
  659. raise InvalidActionError()
  660. return {"result": "success"}, 200
  661. class DocumentDeleteApi(DocumentResource):
  662. @setup_required
  663. @login_required
  664. @account_initialization_required
  665. @cloud_edition_billing_rate_limit_check("knowledge")
  666. def delete(self, dataset_id, document_id):
  667. dataset_id = str(dataset_id)
  668. document_id = str(document_id)
  669. dataset = DatasetService.get_dataset(dataset_id)
  670. if dataset is None:
  671. raise NotFound("Dataset not found.")
  672. # check user's model setting
  673. DatasetService.check_dataset_model_setting(dataset)
  674. document = self.get_document(dataset_id, document_id)
  675. try:
  676. DocumentService.delete_document(document)
  677. except services.errors.document.DocumentIndexingError:
  678. raise DocumentIndexingError("Cannot delete document during indexing.")
  679. return {"result": "success"}, 204
  680. class DocumentMetadataApi(DocumentResource):
  681. @setup_required
  682. @login_required
  683. @account_initialization_required
  684. def put(self, dataset_id, document_id):
  685. dataset_id = str(dataset_id)
  686. document_id = str(document_id)
  687. document = self.get_document(dataset_id, document_id)
  688. req_data = request.get_json()
  689. doc_type = req_data.get("doc_type")
  690. doc_metadata = req_data.get("doc_metadata")
  691. # The role of the current user in the ta table must be admin, owner, dataset_operator, or editor
  692. if not current_user.is_dataset_editor:
  693. raise Forbidden()
  694. if doc_type is None or doc_metadata is None:
  695. raise ValueError("Both doc_type and doc_metadata must be provided.")
  696. if doc_type not in DocumentService.DOCUMENT_METADATA_SCHEMA:
  697. raise ValueError("Invalid doc_type.")
  698. if not isinstance(doc_metadata, dict):
  699. raise ValueError("doc_metadata must be a dictionary.")
  700. metadata_schema: dict = cast(dict, DocumentService.DOCUMENT_METADATA_SCHEMA[doc_type])
  701. document.doc_metadata = {}
  702. if doc_type == "others":
  703. document.doc_metadata = doc_metadata
  704. else:
  705. for key, value_type in metadata_schema.items():
  706. value = doc_metadata.get(key)
  707. if value is not None and isinstance(value, value_type):
  708. document.doc_metadata[key] = value
  709. document.doc_type = doc_type
  710. document.updated_at = datetime.now(UTC).replace(tzinfo=None)
  711. db.session.commit()
  712. return {"result": "success", "message": "Document metadata updated."}, 200
  713. class DocumentStatusApi(DocumentResource):
  714. @setup_required
  715. @login_required
  716. @account_initialization_required
  717. @cloud_edition_billing_resource_check("vector_space")
  718. @cloud_edition_billing_rate_limit_check("knowledge")
  719. def patch(self, dataset_id, action):
  720. dataset_id = str(dataset_id)
  721. dataset = DatasetService.get_dataset(dataset_id)
  722. if dataset is None:
  723. raise NotFound("Dataset not found.")
  724. # The role of the current user in the ta table must be admin, owner, or editor
  725. if not current_user.is_dataset_editor:
  726. raise Forbidden()
  727. # check user's model setting
  728. DatasetService.check_dataset_model_setting(dataset)
  729. # check user's permission
  730. DatasetService.check_dataset_permission(dataset, current_user)
  731. document_ids = request.args.getlist("document_id")
  732. for document_id in document_ids:
  733. document = self.get_document(dataset_id, document_id)
  734. indexing_cache_key = "document_{}_indexing".format(document.id)
  735. cache_result = redis_client.get(indexing_cache_key)
  736. if cache_result is not None:
  737. raise InvalidActionError(f"Document:{document.name} is being indexed, please try again later")
  738. if action == "enable":
  739. if document.enabled:
  740. continue
  741. if current_user not in (TenantAccountRole.ADMIN, TenantAccountRole.OWNER):
  742. document.enable_applicant = current_user.id
  743. document.check_status = 1
  744. db.session.commit()
  745. return {"result": "该操作需要提交管理员审核后生效,请确认是否提交"}, 200
  746. document.enabled = True
  747. document.disabled_at = None
  748. document.disabled_by = None
  749. document.check_by = current_user.id
  750. document.check_at = datetime.now(UTC).replace(tzinfo=None)
  751. document.updated_at = datetime.now(UTC).replace(tzinfo=None)
  752. db.session.commit()
  753. # Set cache to prevent indexing the same document multiple times
  754. redis_client.setex(indexing_cache_key, 600, 1)
  755. add_document_to_index_task.delay(document_id)
  756. # 审核不通过
  757. elif action == "check_fail":
  758. document.enabled = False
  759. document.check_by = current_user.id
  760. document.updated_at = datetime.now(UTC).replace(tzinfo=None)
  761. document.check_status = 2
  762. db.session.commit()
  763. elif action == "disable":
  764. if not document.completed_at or document.indexing_status != "completed":
  765. raise InvalidActionError(f"Document: {document.name} is not completed.")
  766. if not document.enabled:
  767. continue
  768. # 下线判断,非管理员无法提交
  769. if current_user.current_role not in (TenantAccountRole.ADMIN, TenantAccountRole.OWNER):
  770. document.enable_applicant = current_user.id
  771. db.session.commit()
  772. return {"result": "该操作需要提交管理员审核后生效,请确认是否提交"}, 200
  773. document.enabled = False
  774. document.disabled_at = datetime.now(UTC).replace(tzinfo=None)
  775. document.disabled_by = current_user.id
  776. document.updated_at = datetime.now(UTC).replace(tzinfo=None)
  777. document.check_status = 3
  778. db.session.commit()
  779. # Set cache to prevent indexing the same document multiple times
  780. redis_client.setex(indexing_cache_key, 600, 1)
  781. remove_document_from_index_task.delay(document_id)
  782. elif action == "archive":
  783. if document.archived:
  784. continue
  785. document.archived = True
  786. document.archived_at = datetime.now(UTC).replace(tzinfo=None)
  787. document.archived_by = current_user.id
  788. document.updated_at = datetime.now(UTC).replace(tzinfo=None)
  789. db.session.commit()
  790. if document.enabled:
  791. # Set cache to prevent indexing the same document multiple times
  792. redis_client.setex(indexing_cache_key, 600, 1)
  793. remove_document_from_index_task.delay(document_id)
  794. elif action == "un_archive":
  795. if not document.archived:
  796. continue
  797. document.archived = False
  798. document.archived_at = None
  799. document.archived_by = None
  800. document.updated_at = datetime.now(UTC).replace(tzinfo=None)
  801. db.session.commit()
  802. # Set cache to prevent indexing the same document multiple times
  803. redis_client.setex(indexing_cache_key, 600, 1)
  804. add_document_to_index_task.delay(document_id)
  805. else:
  806. raise InvalidActionError()
  807. return {"result": "success"}, 200
  808. class DocumentPauseApi(DocumentResource):
  809. @setup_required
  810. @login_required
  811. @account_initialization_required
  812. @cloud_edition_billing_rate_limit_check("knowledge")
  813. def patch(self, dataset_id, document_id):
  814. """pause document."""
  815. dataset_id = str(dataset_id)
  816. document_id = str(document_id)
  817. dataset = DatasetService.get_dataset(dataset_id)
  818. if not dataset:
  819. raise NotFound("Dataset not found.")
  820. document = DocumentService.get_document(dataset.id, document_id)
  821. # 404 if document not found
  822. if document is None:
  823. raise NotFound("Document Not Exists.")
  824. # 403 if document is archived
  825. if DocumentService.check_archived(document):
  826. raise ArchivedDocumentImmutableError()
  827. try:
  828. # pause document
  829. DocumentService.pause_document(document)
  830. except services.errors.document.DocumentIndexingError:
  831. raise DocumentIndexingError("Cannot pause completed document.")
  832. return {"result": "success"}, 204
  833. class DocumentRecoverApi(DocumentResource):
  834. @setup_required
  835. @login_required
  836. @account_initialization_required
  837. @cloud_edition_billing_rate_limit_check("knowledge")
  838. def patch(self, dataset_id, document_id):
  839. """recover document."""
  840. dataset_id = str(dataset_id)
  841. document_id = str(document_id)
  842. dataset = DatasetService.get_dataset(dataset_id)
  843. if not dataset:
  844. raise NotFound("Dataset not found.")
  845. document = DocumentService.get_document(dataset.id, document_id)
  846. # 404 if document not found
  847. if document is None:
  848. raise NotFound("Document Not Exists.")
  849. # 403 if document is archived
  850. if DocumentService.check_archived(document):
  851. raise ArchivedDocumentImmutableError()
  852. try:
  853. # pause document
  854. DocumentService.recover_document(document)
  855. except services.errors.document.DocumentIndexingError:
  856. raise DocumentIndexingError("Document is not in paused status.")
  857. return {"result": "success"}, 204
  858. class DocumentRetryApi(DocumentResource):
  859. @setup_required
  860. @login_required
  861. @account_initialization_required
  862. @cloud_edition_billing_rate_limit_check("knowledge")
  863. def post(self, dataset_id):
  864. """retry document."""
  865. parser = reqparse.RequestParser()
  866. parser.add_argument("document_ids", type=list, required=True, nullable=False, location="json")
  867. args = parser.parse_args()
  868. dataset_id = str(dataset_id)
  869. dataset = DatasetService.get_dataset(dataset_id)
  870. retry_documents = []
  871. if not dataset:
  872. raise NotFound("Dataset not found.")
  873. for document_id in args["document_ids"]:
  874. try:
  875. document_id = str(document_id)
  876. document = DocumentService.get_document(dataset.id, document_id)
  877. # 404 if document not found
  878. if document is None:
  879. raise NotFound("Document Not Exists.")
  880. # 403 if document is archived
  881. if DocumentService.check_archived(document):
  882. raise ArchivedDocumentImmutableError()
  883. # 400 if document is completed
  884. if document.indexing_status == "completed":
  885. raise DocumentAlreadyFinishedError()
  886. retry_documents.append(document)
  887. except Exception:
  888. logging.exception(f"Failed to retry document, document id: {document_id}")
  889. continue
  890. # retry document
  891. DocumentService.retry_document(dataset_id, retry_documents)
  892. return {"result": "success"}, 204
  893. class DocumentRenameApi(DocumentResource):
  894. @setup_required
  895. @login_required
  896. @account_initialization_required
  897. @marshal_with(document_fields)
  898. def post(self, dataset_id, document_id):
  899. # The role of the current user in the ta table must be admin, owner, editor, or dataset_operator
  900. if not current_user.is_dataset_editor:
  901. raise Forbidden()
  902. dataset = DatasetService.get_dataset(dataset_id)
  903. DatasetService.check_dataset_operator_permission(current_user, dataset)
  904. parser = reqparse.RequestParser()
  905. parser.add_argument("name", type=str, required=True, nullable=False, location="json")
  906. args = parser.parse_args()
  907. try:
  908. document = DocumentService.rename_document(dataset_id, document_id, args["name"])
  909. except services.errors.document.DocumentIndexingError:
  910. raise DocumentIndexingError("Cannot delete document during indexing.")
  911. return document
  912. class WebsiteDocumentSyncApi(DocumentResource):
  913. @setup_required
  914. @login_required
  915. @account_initialization_required
  916. def get(self, dataset_id, document_id):
  917. """sync website document."""
  918. dataset_id = str(dataset_id)
  919. dataset = DatasetService.get_dataset(dataset_id)
  920. if not dataset:
  921. raise NotFound("Dataset not found.")
  922. document_id = str(document_id)
  923. document = DocumentService.get_document(dataset.id, document_id)
  924. if not document:
  925. raise NotFound("Document not found.")
  926. if document.tenant_id != current_user.current_tenant_id:
  927. raise Forbidden("No permission.")
  928. if document.data_source_type != "website_crawl":
  929. raise ValueError("Document is not a website document.")
  930. # 403 if document is archived
  931. if DocumentService.check_archived(document):
  932. raise ArchivedDocumentImmutableError()
  933. # sync document
  934. DocumentService.sync_website_document(dataset_id, document)
  935. return {"result": "success"}, 200
  936. api.add_resource(GetProcessRuleApi, "/datasets/process-rule")
  937. api.add_resource(DatasetDocumentListApi, "/datasets/<uuid:dataset_id>/documents")
  938. api.add_resource(DatasetInitApi, "/datasets/init")
  939. api.add_resource(
  940. DocumentIndexingEstimateApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/indexing-estimate"
  941. )
  942. api.add_resource(DocumentBatchIndexingEstimateApi, "/datasets/<uuid:dataset_id>/batch/<string:batch>/indexing-estimate")
  943. api.add_resource(DocumentBatchIndexingStatusApi, "/datasets/<uuid:dataset_id>/batch/<string:batch>/indexing-status")
  944. api.add_resource(DocumentIndexingStatusApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/indexing-status")
  945. api.add_resource(DocumentDetailApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>")
  946. api.add_resource(
  947. DocumentProcessingApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/processing/<string:action>"
  948. )
  949. api.add_resource(DocumentDeleteApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>")
  950. api.add_resource(DocumentMetadataApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/metadata")
  951. api.add_resource(DocumentStatusApi, "/datasets/<uuid:dataset_id>/documents/status/<string:action>/batch")
  952. api.add_resource(DocumentPauseApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/processing/pause")
  953. api.add_resource(DocumentRecoverApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/processing/resume")
  954. api.add_resource(DocumentRetryApi, "/datasets/<uuid:dataset_id>/retry")
  955. api.add_resource(DocumentRenameApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/rename")
  956. api.add_resource(WebsiteDocumentSyncApi, "/datasets/<uuid:dataset_id>/documents/<uuid:document_id>/website-sync")