常见问题#

如何使用本地文件夹作为 Tokkio 图表的插件资源#

您可以为 ace agent 组件指定本地文件夹路径作为 config_dir 选项。对于 Tokkio，app.yaml 文件中需要以下更新（添加 files 字段）

- name: chat-engine
type: ucf.svc.ace-agent.chat-engine
files:
    config_dir: <path_to_local_folder>
- name: chat-controller
type: ucf.svc.ace-agent.chat-controller
files:
    config_dir: <path_to_local_folder>
- name: plugin-server
type: ucf.svc.ace-agent.plugin-server
files:
    config_dir: <path_to_local_folder>

在相应的 params.yaml 文件中，删除对这些微服务的变量 configNgcPath 提供的 NGC 资源的引用。

如何为参考工作流程中使用的 Avatar 角色提供不同的名称#

Avatar 角色的名称由参考应用程序的插件服务器中给出的提示决定。例如，在以下 Colang 的问候流程中，Avatar 的名称已被嵌入 -

@meta(bot_intent=True)
flow bot express greeting
(bot express "Hi, I am Ben. How can I help you?"
    or bot express "Welcome! My name is Ben. Ask away!"

同样，对于通过 python 模块提供给 LLM 的任何提示更新，可以选择添加系统提示来为 Avatar 提供名称。

旧版 NGC API 密钥和 NGC 个人密钥之间有什么区别？#

旧版 API 密钥：这是 NVIDIA NGC 提供的初始类型的 API 密钥。它授予对各种 NGC 服务的访问权限，但缺乏高级管理功能。

个人 API 密钥：为了增强安全性和管理，引入了个人 API 密钥，它与 NGC 组织内的个人用户相关联。它们比原始 API 密钥具有以下几个优势

基于角色的访问控制 (RBAC)：个人 API 密钥支持 RBAC，允许管理员为每个用户定义特定的权限，从而控制对不同 NGC 服务和资源的访问。

生命周期管理：这些密钥与用户在 NGC 组织内的生命周期相关联。如果用户离开组织或其角色发生变化，则可以相应地撤销或调整其个人 API 密钥。

密钥管理功能：用户可以根据需要设置过期日期、撤销、删除或轮换其个人 API 密钥，从而提供更大的控制和安全性。

如何将自定义 Bot 从 Colang 2 alpha 迁移到 Colang 2 beta#

有关迁移的指导，请参阅 Colang 文档。

如何在插件服务器资源中添加其他库#

插件服务器资源是一个 python 模块。像通常对任何 python 代码一样导入所需的库。示例

from openai import OpenAI, AsyncOpenAI

在 requirements.txt 文件中添加其他模块/版本

Tokkio UI 和 Tokkio Iframe 之间有什么区别？#

Tokkio Iframe 是一个最小的 UI，仅包含 Avatar 流和一些基本控件，但没有其他内容。它不支持许多功能，包括 ASR/TTS 脚本、零售用例、用户注意力指示器等。Iframe 旨在嵌入到网站中，但它也可以单独部署。

Tokkio UI 利用了 Tokkio 所有功能的全部功能。它支持所有 Tokkio 功能，并可用于创建完全可自定义的用户体验，其中包括 Avatar 对话以及其他类型的用户输入，例如触摸菜单。

如何将 Tokkio Iframe 嵌入到我的网站中？#

请访问 Iframe 文档中的 将 Iframe 嵌入到网站 部分，了解有关如何执行此操作的详细信息。

在本页中