Thiếu quyền manage_ai_knowledge bị từ chối. File đã trùng nội dung trong tòa nhà không được tải lại. Tài liệu, các đoạn và audit được lưu cùng transaction sau khi tạo embedding.Không có GET danh sách tài liệu trên route này; giao diện admin tải danh sách qua repository phía server.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Taho","description":"Tài liệu hành vi hiện tại của hệ thống Taho, được xác minh từ source code.","colors":{"primary":"#8A5A00","light":"#F3BA2F","dark":"#B08020"},"logo":{"light":"https://mintcdn.com/taho-a5b7eb2b/qpXbhngqabQW8FVI/logo/light.svg?fit=max\u0026auto=format\u0026n=qpXbhngqabQW8FVI\u0026q=85\u0026s=9c77740b78f781548956801966e2e927","dark":"https://mintcdn.com/taho-a5b7eb2b/qpXbhngqabQW8FVI/logo/dark.svg?fit=max\u0026auto=format\u0026n=qpXbhngqabQW8FVI\u0026q=85\u0026s=64873ec19459d1629b770ec7d16f99aa","href":"/"},"favicon":"https://mintcdn.com/taho-a5b7eb2b/qpXbhngqabQW8FVI/favicon.svg?fit=max\u0026auto=format\u0026n=qpXbhngqabQW8FVI\u0026q=85\u0026s=9762ba4d8b5241abbb0517f9e2d1d43d","api":{"playground":{"display":"simple"}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"icon":"globe","href":"https://taho.com.vn/","label":"Trang chủ"},{"icon":"mail","href":"mailto:contact@taho.com.vn","label":"Liên hệ"}]},"footer":{"socials":{"website":"https://taho.com.vn/"},"links":[{"header":"Taho","items":[{"label":"Trang chủ","href":"https://taho.com.vn/"},{"label":"contact@taho.com.vn","href":"mailto:contact@taho.com.vn"}]}]},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"taho-a5b7eb2b","hasAudioNarration":false,"actualSubdomain":"taho-a5b7eb2b","customDomains":["docs.taho.com.vn"],"gitSource":{"type":"github","owner":"taho-vn","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ac5fbcf78c1c22ae0f122ec","collectionId":"a5207557-1faf-4071-89fd-270931402be2","liveDeploymentHistoryId":"6ac5fbcf78c1c22ae0f122ec","schemaVersion":"v3"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adad01462b6f64d97e13178","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Nghiệp vụ","count":20},{"language":"default","tag":"Kỹ thuật","count":11},{"language":"default","tag":"Công nợ và thanh toán","count":10},{"language":"default","tag":"API / Swagger","count":9},{"language":"default","tag":"Tra cứu","count":8},{"language":"default","tag":"Phát triển","count":7},{"language":"default","tag":"Mini App","count":6},{"language":"default","tag":"Danh mục kỹ thuật","count":5},{"language":"default","tag":"Trợ lý AI","count":4},{"language":"default","tag":"Bắt đầu","count":4}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".taho-home{--taho-ink:#191a1d;--taho-muted:#545861;--taho-line:#e5e5e1;--taho-accent:#f3ba2f;color:var(--taho-ink);max-width:1180px;margin:0 auto;padding:56px 28px 96px}.taho-home *{box-sizing:border-box}.taho-home a:focus-visible{outline:3px solid #8a5a00;outline-offset:3px}.taho-hero{display:grid;grid-template-columns:minmax(0,1.2fr) minmax(290px,.8fr);gap:clamp(28px,5vw,70px);align-items:center;padding:clamp(34px,6vw,72px);border:1px solid #e8e4d8;border-radius:24px;background:radial-gradient(circle at 96% 5%,#fff0c6 0,transparent 40%),#faf9f6}.taho-eyebrow{color:#8a5a00;font-size:11px;font-weight:800;letter-spacing:.14em;margin:0 0 18px}.taho-home h1,.taho-home h2,.taho-home h3{color:var(--taho-ink);letter-spacing:-.035em}.taho-home h1{font-size:clamp(40px,5vw,65px);line-height:1.06;margin:0 0 22px;font-weight:760}.taho-home h1 span{background:var(--taho-accent);border-radius:13px;padding:0 .13em;white-space:nowrap}.taho-lead{color:var(--taho-muted);font-size:17px;line-height:1.7;max-width:580px;margin:0 0 32px}.taho-hero-actions{display:flex;flex-wrap:wrap;gap:11px}.taho-button,.taho-hero-map a{align-items:center;text-decoration:none!important}.taho-button{display:inline-flex;justify-content:center;gap:18px;min-height:45px;border-radius:9px;padding:11px 16px;font-size:13px;font-weight:750;transition:transform .18s ease,box-shadow .18s ease}.taho-button:hover{transform:translateY(-2px);box-shadow:0 8px 18px #17171718}.taho-button-primary{background:var(--taho-accent);color:#171717!important}.taho-button-secondary{border:1px solid #cfcfc9;background:#fff;color:var(--taho-ink)!important}.taho-hero-map{background:#1d1f22;color:#fff;border-radius:16px;padding:20px 24px 17px;box-shadow:0 18px 40px #1111111e}.taho-map-label{color:#f3ba2f;font-size:11px;font-weight:800;letter-spacing:.14em;margin:0 0 6px}.taho-hero-map a{display:grid;grid-template-columns:32px 1fr auto;gap:9px;padding:17px 0;border-bottom:1px solid #414247;color:#fff!important;font-size:14px;font-weight:700}.taho-hero-map a:hover{color:#f3ba2f!important}.taho-map-index{color:#f3ba2f;font-size:12px}.taho-hero-map small{display:block;margin-top:3px;color:#bdc0c5;font-size:12px;font-weight:400;line-height:1.45}.taho-map-note{color:#bdc0c5;font-size:11px;margin:14px 0 0}.taho-section{padding-top:84px}.taho-home h2{font-size:clamp(28px,3.1vw,39px);line-height:1.16;margin:0 0 13px}.taho-section-intro{color:var(--taho-muted);margin:0 0 28px}.taho-path-grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:14px}.taho-path-card{display:flex;flex-direction:column;align-items:flex-start;min-height:228px;gap:13px;padding:24px;border:1px solid var(--taho-line);border-radius:14px;color:var(--taho-muted)!important;text-decoration:none!important;background:#fff;transition:border-color .18s ease,transform .18s ease,box-shadow .18s ease}.taho-path-card:hover{transform:translateY(-3px);border-color:#d4a520;box-shadow:0 12px 30px #17171712}.taho-card-number{color:#8a5a00;font-size:10px;font-weight:800;letter-spacing:.1em}.taho-path-card strong{color:var(--taho-ink);font-size:19px;line-height:1.2;letter-spacing:-.02em}.taho-path-card>span:nth-of-type(2){font-size:13px;line-height:1.6}.taho-card-link{margin-top:auto;color:#72500a;font-size:12px;font-weight:800}.taho-topic-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:28px;margin-top:23px;border-top:1px solid var(--taho-line)}.taho-topic{padding:26px 0 0}.taho-topic h3{font-size:19px;margin:0 0 8px}.taho-topic p{color:var(--taho-muted);font-size:13px;line-height:1.6;min-height:62px;margin:0 0 16px}.taho-topic div{display:flex;flex-direction:column;align-items:flex-start;gap:8px}.taho-topic a{color:#72500a!important;font-size:13px;font-weight:700;text-decoration:none!important}.taho-reference-links a:hover,.taho-topic a:hover{text-decoration:underline!important}.taho-reference{display:grid;grid-template-columns:1.4fr 1fr;gap:40px;padding:36px;margin-top:84px;background:#f6f6f3;border-radius:16px}.taho-reference .taho-eyebrow{margin-bottom:12px}.taho-reference h2{font-size:27px}.taho-reference p:last-child{color:var(--taho-muted);line-height:1.65;font-size:13px;margin:0}.taho-reference-links{display:flex;flex-direction:column;justify-content:center}.taho-reference-links a{padding:13px 0;display:flex;justify-content:space-between;border-bottom:1px solid #d9d9d4;color:var(--taho-ink)!important;font-weight:700;font-size:13px;text-decoration:none!important}@media (max-width:900px){.taho-hero{grid-template-columns:1fr}.taho-path-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.taho-topic-grid{grid-template-columns:1fr;gap:0}.taho-topic p{min-height:0}}@media (max-width:600px){.taho-home{padding:24px 16px 70px}.taho-hero{padding:28px 20px;border-radius:16px}.taho-section{padding-top:60px}.taho-path-grid{grid-template-columns:1fr}.taho-path-card{min-height:170px}.taho-reference{margin-top:60px;padding:24px;grid-template-columns:1fr;gap:16px}}"}],"page":{"pagePath":"api-reference/ai-knowledge-upload","slug":"/api-reference/ai-knowledge-upload","pageMetadata":{"title":"Tải tài liệu tri thức","description":"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.","keywords":["API","OpenAPI","POST","/admin/ai/knowledge"],"openapi":"openapi.json POST /admin/ai/knowledge","href":"/api-reference/ai-knowledge-upload"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Thiếu quyền `,_jsx(_components.code,{children:`manage_ai_knowledge`}),` bị từ chối. File đã trùng nội dung trong tòa nhà không được tải lại. Tài liệu, các đoạn và audit được lưu cùng transaction sau khi tạo embedding.`]}),`\n`,_jsx(_components.p,{children:`Không có GET danh sách tài liệu trên route này; giao diện admin tải danh sách qua repository phía server.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Tải tài liệu tri thức","description":"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.","keywords":["API","OpenAPI","POST","/admin/ai/knowledge"],"openapi":"openapi.json POST /admin/ai/knowledge","href":"/api-reference/ai-knowledge-upload"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"uploadAiKnowledge","summary":"Tải tài liệu và lập chỉ mục","tags":["AI"],"security":["1364ad79-c822-44d9-9d66-fcb01250dd27","597528e8-0f5a-4408-a63b-006baa78b0b6"],"description":"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.","requestBody":"92a7bbc8-ed70-4085-89c2-3868b0105c63","responses":{"201":"e6752634-765d-42b3-a651-c45202143261","400":"2f4fada7-6d9b-4b2c-bc7e-2b0575318d55","401":"a0a08808-99f8-46e9-8102-aec02a313b50","403":"d5dad56f-e144-4658-bd6f-de82f37d2258","413":"cefe515a-7a51-4902-a0bb-3a92cbae369f","500":"fe027f79-ce92-42ce-bd23-3a7fbb4488f2","503":"57825bc2-0697-42f0-bd7b-3f1cce1e54ff"},"method":"post","type":"path","servers":[],"path":"/admin/ai/knowledge","baseUrlOptions":[],"title":"Tải tài liệu và lập chỉ mục","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"Tệp văn bản được hỗ trợ; kiểm tra extension, MIME và nội dung trích xuất.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"title":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"title","typeLabel":"string"},"category":{"type":"string","enum":["general","accounting","operations","residents","maintenance","services","safety","legal"],"default":"general","uniqueKey":"category","typeLabel":"enum\u003cstring>"}},"required":["file","title"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","title":"\u003cstring>","category":"general"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e6752634-765d-42b3-a651-c45202143261":{"description":"Tài liệu sau khi tạo embedding, lưu đoạn và audit.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"object","properties":{"document":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"data.document.id","typeLabel":"integer"},"title":{"type":"string","uniqueKey":"data.document.title","typeLabel":"string"},"category":{"type":"string","uniqueKey":"data.document.category","typeLabel":"string"},"fileName":{"type":"string","uniqueKey":"data.document.fileName","typeLabel":"string"},"status":{"type":"string","uniqueKey":"data.document.status","typeLabel":"string"},"chunkCount":{"type":"integer","uniqueKey":"data.document.chunkCount","typeLabel":"integer"},"createdAt":{"type":"string","uniqueKey":"data.document.createdAt","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"data.document","typeLabel":"object"}},"required":["document"],"additionalProperties":true,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["success","data"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"document":{"id":123,"title":"\u003cstring>","category":"\u003cstring>","fileName":"\u003cstring>","status":"\u003cstring>","chunkCount":123,"createdAt":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"2f4fada7-6d9b-4b2c-bc7e-2b0575318d55":{"description":"invalid-knowledge.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"required":["code","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a0a08808-99f8-46e9-8102-aec02a313b50":{"description":"unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"required":["code","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d5dad56f-e144-4658-bd6f-de82f37d2258":{"description":"forbidden-origin hoặc forbidden.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"required":["code","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"cefe515a-7a51-4902-a0bb-3a92cbae369f":{"description":"request-too-large khi vượt giới hạn request.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"required":["code","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fe027f79-ce92-42ce-bd23-3a7fbb4488f2":{"description":"knowledge-unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"required":["code","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"57825bc2-0697-42f0-bd7b-3f1cce1e54ff":{"description":"ai-not-configured.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"}},"required":["code","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1364ad79-c822-44d9-9d66-fcb01250dd27":{"AdminBearer":{"type":"http","scheme":"bearer","description":"Token phiên quản trị, vẫn phải qua route/action và active tower checks.","scopes":[],"schemeName":"AdminBearer"}},"597528e8-0f5a-4408-a63b-006baa78b0b6":{"AdminCookie":{"type":"apiKey","in":"cookie","name":"taho_jwt","scopes":[],"schemeName":"AdminCookie"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Token phiên quản trị, vẫn phải qua route/action và active tower checks.","scopes":[],"schemeName":"AdminBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Token phiên quản trị, vẫn phải qua route/action và active tower checks.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AdminBearer","name":"Authorization"}],"title":"AdminBearer"},{"schemes":[{"scheme":{"type":"apiKey","in":"cookie","name":"taho_jwt","scopes":[],"schemeName":"AdminCookie"},"schema":{"title":"taho_jwt","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AdminCookie","name":"taho_jwt"}],"title":"AdminCookie"}]},"originalFileLocation":"openapi.json"},"subdomain":"taho-a5b7eb2b","siteName":"Taho","title":"Tải tài liệu tri thức - Taho","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T07:59:23.019Z","originalFileLocation":"api-reference/ai-knowledge-upload.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Taho\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Tải tài liệu tri thức - Taho\">\u003cmeta data-mint-head property=\"og:description\" content=\"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Taho\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://taho-a5b7eb2b.mintlify.app/_mintlify/api/og/v2?division=Tr%E1%BB%A3+l%C3%BD+AI\u0026amp;title=T%E1%BA%A3i+t%C3%A0i+li%E1%BB%87u+tri+th%E1%BB%A9c\u0026amp;description=Tr%C3%ADch+v%C4%83n+b%E1%BA%A3n%2C+t%E1%BA%A1o+embedding+v%C3%A0+l%C6%B0u+t%C3%A0i+li%E1%BB%87u+theo+t%C3%B2a+nh%C3%A0.\u0026amp;theme=b39568b17f0020cbd4c9afa8\u0026amp;signature=532841b0a7d88abd4ff846d3c072c0115e188e0345a44e77afb148de2df7628d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Tải tài liệu tri thức - Taho\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://taho-a5b7eb2b.mintlify.app/_mintlify/api/og/v2?division=Tr%E1%BB%A3+l%C3%BD+AI\u0026amp;title=T%E1%BA%A3i+t%C3%A0i+li%E1%BB%87u+tri+th%E1%BB%A9c\u0026amp;description=Tr%C3%ADch+v%C4%83n+b%E1%BA%A3n%2C+t%E1%BA%A1o+embedding+v%C3%A0+l%C6%B0u+t%C3%A0i+li%E1%BB%87u+theo+t%C3%B2a+nh%C3%A0.\u0026amp;theme=b39568b17f0020cbd4c9afa8\u0026amp;signature=532841b0a7d88abd4ff846d3c072c0115e188e0345a44e77afb148de2df7628d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/taho-a5b7eb2b/FZaR2m99oriv2xkR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Taho\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8A5A00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ai-knowledge-upload.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.taho.com.vn/#organization\",\"name\":\"Taho\",\"url\":\"https://docs.taho.com.vn\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/taho-a5b7eb2b/qpXbhngqabQW8FVI/logo/light.svg?fit=max\u0026auto=format\u0026n=qpXbhngqabQW8FVI\u0026q=85\u0026s=9c77740b78f781548956801966e2e927\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.taho.com.vn#website\",\"name\":\"Taho\",\"url\":\"https://docs.taho.com.vn\",\"publisher\":{\"@id\":\"https://docs.taho.com.vn/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload#webpage\",\"url\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload\",\"name\":\"Tải tài liệu tri thức\",\"description\":\"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.\",\"dateModified\":\"2026-10-07T07:59:23.019Z\",\"isPartOf\":{\"@id\":\"https://docs.taho.com.vn#website\"},\"breadcrumb\":{\"@id\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Trợ lý AI\",\"item\":\"https://docs.taho.com.vn/api-reference/ai-history\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tải tài liệu tri thức\",\"item\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload#apireference\",\"headline\":\"Tải tài liệu tri thức\",\"name\":\"Tải tài liệu tri thức\",\"description\":\"Trích văn bản, tạo embedding và lưu tài liệu theo tòa nhà.\",\"url\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload\",\"mainEntityOfPage\":{\"@id\":\"https://docs.taho.com.vn/api-reference/ai-knowledge-upload#webpage\"},\"dateModified\":\"2026-10-07T07:59:23.019Z\",\"keywords\":\"API, OpenAPI, POST, /admin/ai/knowledge\",\"publisher\":{\"@id\":\"https://docs.taho.com.vn/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.taho.com.vn#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Taho\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Taho","nav":{"global":null,"tabs":[{"tab":"Bắt đầu","pages":[{"title":"Bắt đầu","href":""}]},{"tab":"Nghiệp vụ","pages":[{"title":"Nghiệp vụ","href":"/operations/apartments-residents"}]},{"tab":"AI","pages":[{"title":"AI","href":"/ai"}]},{"tab":"Mini App","pages":[{"title":"Mini App","href":"/mini-app"}]},{"tab":"API / Swagger","pages":[{"title":"API / Swagger","href":"/api-reference"},{"group":"Mini App","pages":[{"title":"Xác minh danh tính Zalo","openapi":"openapi.json POST /api/resident/auth/zalo","href":"/api-reference/resident-auth"},{"title":"Đọc portal cư dân","openapi":"openapi.json GET /api/resident/portal","href":"/api-reference/resident-portal"},{"title":"Gửi thao tác cư dân","openapi":"openapi.json POST /api/resident/portal","href":"/api-reference/resident-actions"},{"title":"Duyệt quyền căn hộ","openapi":"openapi.json POST /admin/resident-miniapp/action","href":"/api-reference/resident-access-review"}]},{"group":"Trợ lý AI","pages":[{"title":"Đọc lịch sử AI","openapi":"openapi.json GET /admin/ai/chat","href":"/api-reference/ai-history"},{"title":"Gửi câu hỏi AI","description":"Tạo câu trả lời từ tài liệu, lịch sử và công cụ dữ liệu được phép.","openapi":"openapi.json POST /admin/ai/chat","href":"/api-reference/ai-chat"},{"title":"Tải tài liệu tri thức","openapi":"openapi.json POST /admin/ai/knowledge","href":"/api-reference/ai-knowledge-upload"},{"title":"Lưu trữ tài liệu tri thức","description":"Chuyển tài liệu đang hoạt động sang trạng thái lưu trữ.","openapi":"openapi.json DELETE /admin/ai/knowledge","href":"/api-reference/ai-knowledge-archive"}]}],"groups":[{"group":"Mini App","pages":[{"title":"Xác minh danh tính Zalo","deprecated":null,"version":null,"openapi":"/openapi.json post /api/resident/auth/zalo","href":"/api-reference/mini-app/xác-minh-danh-tính-zalo"},{"title":"Đọc portal cư dân","deprecated":null,"version":null,"openapi":"/openapi.json get /api/resident/portal","href":"/api-reference/mini-app/đọc-portal-cư-dân"},{"title":"Gửi liên kết hoặc yêu cầu cư dân","deprecated":null,"version":null,"openapi":"/openapi.json post /api/resident/portal","href":"/api-reference/mini-app/gửi-liên-kết-hoặc-yêu-cầu-cư-dân"}]},{"group":"Admin Mini App","pages":[{"title":"Duyệt, từ chối hoặc thu hồi quyền căn hộ","deprecated":null,"version":null,"openapi":"/openapi.json post /admin/resident-miniapp/action","href":"/api-reference/admin-mini-app/duyệt-từ-chối-hoặc-thu-hồi-quyền-căn-hộ"}]},{"group":"AI","pages":[{"title":"Đọc lịch sử trò chuyện AI","deprecated":null,"version":null,"openapi":"/openapi.json get /admin/ai/chat","href":"/api-reference/ai/đọc-lịch-sử-trò-chuyện-ai"},{"title":"Gửi câu hỏi AI","deprecated":null,"version":null,"openapi":"/openapi.json post /admin/ai/chat","href":"/api-reference/ai/gửi-câu-hỏi-ai"},{"title":"Tải tài liệu và lập chỉ mục","deprecated":null,"version":null,"openapi":"/openapi.json post /admin/ai/knowledge","href":"/api-reference/ai/tải-tài-liệu-và-lập-chỉ-mục"},{"title":"Lưu trữ tài liệu AI","deprecated":null,"version":null,"openapi":"/openapi.json delete /admin/ai/knowledge","href":"/api-reference/ai/lưu-trữ-tài-liệu-ai"}]}]},{"tab":"Kỹ thuật","pages":[{"title":"Kỹ thuật","href":"/product-specs/domain-model"}]},{"tab":"Tra cứu","pages":[{"title":"Tra cứu","href":"/reference/route-catalog"}]}]},"basePath":"","title":"Tải tài liệu tri thức - Taho","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}