Server trả JSON sau khi xử lý xong. Câu hỏi được trim; validation độ dài trong service chạy sau bước embedding/tìm tài liệu của handler. Không giả định câu hỏi không hợp lệ luôn bị từ chối trước khi gọi OpenAI.Xem Trợ lý AI để hiểu dữ liệu gửi tới provider và giới hạn tra cứu.
{"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-chat","slug":"/api-reference/ai-chat","pageMetadata":{"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.","keywords":["API","OpenAPI","POST","/admin/ai/chat"],"openapi":"openapi.json POST /admin/ai/chat","href":"/api-reference/ai-chat"},"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: \"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.\"\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={a:`a`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Server trả JSON sau khi xử lý xong. Câu hỏi được trim; validation độ dài trong service chạy sau bước embedding/tìm tài liệu của handler. Không giả định câu hỏi không hợp lệ luôn bị từ chối trước khi gọi OpenAI.`}),`\n`,_jsxs(_components.p,{children:[`Xem `,_jsx(_components.a,{href:`/ai/index`,children:`Trợ lý AI`}),` để hiểu dữ liệu gửi tới provider và giới hạn tra cứu.`]})]})}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":"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.","keywords":["API","OpenAPI","POST","/admin/ai/chat"],"openapi":"openapi.json POST /admin/ai/chat","href":"/api-reference/ai-chat"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"sendAiMessage","summary":"Gửi câu hỏi AI","tags":["AI"],"security":["68050d34-4c5b-4b76-a2b3-6dec0b4bcaa6","f0bcccbb-1cef-48a3-abb5-c0c03cfc948e"],"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.","requestBody":"3051448b-e04d-42aa-a9a3-d7a93cce89c9","responses":{"200":"42f7145b-f32a-4fa2-a538-7b3b96fef430","400":"7e13272a-89ec-4515-aeb1-86c7b138d673","401":"9fd1c1b1-f076-4747-8afd-9b9c8649c52e","403":"20a79cdb-c32b-46b4-89b4-870e7692703c","413":"84d3befb-fe06-4ee1-a7fb-84f0a0764942","429":"f9ff73c3-8104-4f64-a264-864cac5b0e9f","502":"988ad69b-2f27-4be3-ac4d-4a160ee326aa","503":"dd945424-22d4-409f-9b6f-97cf40a79fb9"},"method":"post","type":"path","servers":[],"path":"/admin/ai/chat","baseUrlOptions":[],"title":"Gửi câu hỏi AI","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4000,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"threadId":{"type":"string","description":"Bỏ trống để tạo thread mới; có giá trị phải thuộc chủ và tòa nhà.","uniqueKey":"threadId","typeLabel":"string"}},"required":["message"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","threadId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"42f7145b-f32a-4fa2-a538-7b3b96fef430":{"description":"Câu trả lời sau khi ghi lượt hỏi–đáp.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"object","properties":{"threadId":{"type":"string","isRequired":true,"uniqueKey":"data.threadId","typeLabel":"string"},"message":{"type":"object","properties":{"role":{"type":"string","enum":["assistant"],"isRequired":true,"uniqueKey":"data.message.role","typeLabel":"enum\u003cstring>"},"content":{"type":"string","isRequired":true,"uniqueKey":"data.message.content","typeLabel":"string"},"citations":{"type":"array","items":{"type":"string","uniqueKey":"data.message.citations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.message.citations","typeLabel":"string[]"}},"required":["role","content","citations"],"additionalProperties":true,"isRequired":true,"uniqueKey":"data.message","typeLabel":"object"},"model":{"type":"string","isRequired":true,"uniqueKey":"data.model","typeLabel":"string"}},"required":["threadId","message","model"],"additionalProperties":true,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["success","data"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"threadId":"\u003cstring>","message":{"role":"assistant","content":"\u003cstring>","citations":["\u003cstring>"]},"model":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7e13272a-89ec-4515-aeb1-86c7b138d673":{"description":"invalid-chat-request cho lỗi được publicChatError nhận diện.","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"},"9fd1c1b1-f076-4747-8afd-9b9c8649c52e":{"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"},"20a79cdb-c32b-46b4-89b4-870e7692703c":{"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"},"84d3befb-fe06-4ee1-a7fb-84f0a0764942":{"description":"request-too-large.","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"},"f9ff73c3-8104-4f64-a264-864cac5b0e9f":{"description":"rate-limited.","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"},"988ad69b-2f27-4be3-ac4d-4a160ee326aa":{"description":"ai-unavailable; JSON lỗi cú pháp ngoài nhóm nhận diện cũng tới catch chung.","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"},"dd945424-22d4-409f-9b6f-97cf40a79fb9":{"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":{"68050d34-4c5b-4b76-a2b3-6dec0b4bcaa6":{"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"}},"f0bcccbb-1cef-48a3-abb5-c0c03cfc948e":{"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":"Gửi câu hỏi AI - Taho","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T07:59:23.018Z","originalFileLocation":"api-reference/ai-chat.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=\"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.\">\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=\"Gửi câu hỏi AI - Taho\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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-chat\">\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=G%E1%BB%ADi+c%C3%A2u+h%E1%BB%8Fi+AI\u0026amp;description=T%E1%BA%A1o+c%C3%A2u+tr%E1%BA%A3+l%E1%BB%9Di+t%E1%BB%AB+t%C3%A0i+li%E1%BB%87u%2C+l%E1%BB%8Bch+s%E1%BB%AD+v%C3%A0+c%C3%B4ng+c%E1%BB%A5+d%E1%BB%AF+li%E1%BB%87u+%C4%91%C6%B0%E1%BB%A3c+ph%C3%A9p.\u0026amp;theme=b39568b17f0020cbd4c9afa8\u0026amp;signature=621dcf57ea26d04e2bc7b1bfb64bf9ddab62458b71b38dbca03e59d16fd899b5\">\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=\"Gửi câu hỏi AI - Taho\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\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=G%E1%BB%ADi+c%C3%A2u+h%E1%BB%8Fi+AI\u0026amp;description=T%E1%BA%A1o+c%C3%A2u+tr%E1%BA%A3+l%E1%BB%9Di+t%E1%BB%AB+t%C3%A0i+li%E1%BB%87u%2C+l%E1%BB%8Bch+s%E1%BB%AD+v%C3%A0+c%C3%B4ng+c%E1%BB%A5+d%E1%BB%AF+li%E1%BB%87u+%C4%91%C6%B0%E1%BB%A3c+ph%C3%A9p.\u0026amp;theme=b39568b17f0020cbd4c9afa8\u0026amp;signature=621dcf57ea26d04e2bc7b1bfb64bf9ddab62458b71b38dbca03e59d16fd899b5\">\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-chat\">\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-chat.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-chat#webpage\",\"url\":\"https://docs.taho.com.vn/api-reference/ai-chat\",\"name\":\"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.\",\"dateModified\":\"2026-10-07T07:59:23.018Z\",\"isPartOf\":{\"@id\":\"https://docs.taho.com.vn#website\"},\"breadcrumb\":{\"@id\":\"https://docs.taho.com.vn/api-reference/ai-chat#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.taho.com.vn/api-reference/ai-chat#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\":\"Gửi câu hỏi AI\",\"item\":\"https://docs.taho.com.vn/api-reference/ai-chat\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.taho.com.vn/api-reference/ai-chat#apireference\",\"headline\":\"Gửi câu hỏi AI\",\"name\":\"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.\",\"url\":\"https://docs.taho.com.vn/api-reference/ai-chat\",\"mainEntityOfPage\":{\"@id\":\"https://docs.taho.com.vn/api-reference/ai-chat#webpage\"},\"dateModified\":\"2026-10-07T07:59:23.018Z\",\"keywords\":\"API, OpenAPI, POST, /admin/ai/chat\",\"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","description":"Đọc danh sách cuộc trò chuyện hoặc tin nhắn theo chủ và tòa nhà.","openapi":"openapi.json GET /admin/ai/chat","href":"/api-reference/ai-history"},{"title":"Gửi câu hỏi AI","openapi":"openapi.json POST /admin/ai/chat","href":"/api-reference/ai-chat"},{"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à.","openapi":"openapi.json POST /admin/ai/knowledge","href":"/api-reference/ai-knowledge-upload"},{"title":"Lưu trữ tài liệu tri thức","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":"Gửi câu hỏi AI - 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"]}