Viavitna
文档

从内容到上线助手

四个步骤，无需构建工具，无需 SDK。会粘贴一行脚本，就能上线 Viavitna。

快速入门

1 · 上传 → 2 · 测试 → 3 · 发布 → 4 · 嵌入

  1. 上传您的内容。在控制台中选择一个客户标识并上传文件 — Markdown、HTML 或纯文本。这会构建一份草稿：可检索、带版本、访客不可见。
  2. 测试草稿。用客户的真实问题提问，检查出处。随意反复上传与测试。
  3. 发布。一键将草稿推至线上，并生成您的密钥：可公开的 pub_…（用于组件）与机密的 sec_…（服务器间调用 — 请妥善保存，仅显示一次）。
  4. 嵌入。在您网站的 </body> 前粘贴：
<script src="https://viavitna.com/widget.js"
        data-viau-tenant="your-company"
        data-viau-key="pub_..." data-viau-lang="zh" defer></script>

然后在控制台设置来源白名单，把密钥锁定到您的网站（也可以交给我们来做）。

参考

组件属性

属性必填含义
data-viau-tenant是您的客户标识。
data-viau-key是您的可公开密钥（pub_…）。可安全嵌入；请用来源白名单保护。
data-viau-title否面板标题。
data-viau-lang否en（默认）、es 或 zh — 界面与回答的语言。
data-viau-host否覆盖 API 主机（默认为脚本来源）。

回答 API

POST https://viavitna.com/t/<tenant>/answer
请求头:  content-type: application/json
         x-viau-public-key: pub_...    （浏览器）  — 或 —
         x-viau-key: sec_...           （服务器间）
请求体:  {"question": "如何退货？", "language": "zh"}
结果含义
status: insufficient您的内容未涵盖该问题；回答会如实说明。
mode: generated依据您的段落撰写、经过校验并注明出处的回答。
mode: extractive_fallback逐字的原文相关段落 — 在生成不可用或未通过校验时提供。同样有出处，同样真实。
401 / 403 / 429密钥无效 / 来源不允许 / 触发限流。

内容建议

获取访问权限 流程如何运作