> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/omniverse-extension.md).

# Omniverse 扩展

本指南将向你展示如何使用 Convai Extension 插件集成 Convai 和 NVIDIA Omniverse。

{% embed url="<https://www.youtube.com/playlist?list=PLn_7tCx0ChiqbU3J3JPIKagfiv6S3wK7i>" %}
扩展概览
{% endembed %}

### 安装

要安装 Convai Omniverse 扩展，请按照以下步骤操作：

1. 下载 [最新版本](https://github.com/Conv-AI/ov_extension/archive/refs/tags/1.0.3.zip) 的扩展。
2. 将 zip 文件解压到你选择的目录中。
3. 打开你选择的 Omniverse 应用（例如 Code），然后从 `窗口` 菜单中点击 `扩展`.
4. 在 `扩展` 选项卡，点击右上角的齿轮图标。\
   ![](https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F2cu1hZY6uf5rplCgitTq%2Fimage.png?alt=media\&token=07351793-a073-499a-b459-4b2b35392ac5)
5. 点击 Edit 列中的绿色加号图标，并添加绝对路径到 `exts` 仓库目录中的文件夹。<br>

   <figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FW1QotWmSkiK3MjcITmyU%2Fimage.png?alt=media&amp;token=4aceaf97-7a21-4828-a49e-353c37c2698e" alt=""><figcaption></figcaption></figure>
6. 选中 `第三方` 选项卡并搜索 `Convai` 在左上角的搜索栏中，确保勾选 Enabled。<br>

   <figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FLU5kKUss7w4r4QTFHd2e%2Fimage.png?alt=media&amp;token=ba8d551c-4edc-44cd-a8a4-fc1a16b1456d" alt=""><figcaption></figcaption></figure>
7. Convai 窗口应该会出现，将其拖动并停靠到 UI 的任何合适区域。
8. 如果 Convai 窗口没有出现，请转到 `窗口` 菜单并选择 `Convai` 从列表中选择。

## 配置

要添加你的 API Key 和 Character ID，请按照以下步骤操作：

1. 在以下网址注册： [Convai](https://convai.com/).
2. 在网站上，点击 playground 右上角的齿轮图标，然后将 API key 复制并粘贴到 `Convai API Key` Convai 扩展窗口中的字段。
3. 前往 [仪表板](https://convai.com/pipeline/dashboard) 并在左侧面板中创建一个新角色，或者选择一个示例角色。
4. 复制 Character ID，并将其粘贴到 `角色 ID` 扩展窗口中的字段中。

## 与角色互动

1. 点击 `Start Talking` 以发起对话
2. 点击 `停止` 说完后，等待角色回应。

### 运行演示

1. 打开你选择的 Omniverse 应用（例如 Code）。
2. 前往 `文件->打开` 并导航到仓库目录。
3. 导航到 `<repo directory>/ConvaiDemoStage/ConvaiDemo.usd` 然后点击 \`open it.
4. 点击 `播放` 按钮，从 `工具栏` 左侧菜单中。\
   ![](https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FrXfNmHV74MAe0CIjZSjS%2Fimage.png?alt=media\&token=33567059-0e53-4ad2-aee8-886ac2d105f0)
5. 点击 `Start Talking` ，位于 `Convai` 窗口与角色对话，然后点击 `停止` 以发送请求。

## 动作

操作可用于触发与以下位置中动作同名的事件： `动作图`。它们可用于根据接收到的动作运行动画。要尝试动作：

1. 在 `逗号分隔的动作` 字段中添加几个以逗号分隔的动作（例如 jump、kick、dance 等）。
2. 角色会根据对话选择其中一个动作，并在以下位置运行与该动作同名的任何事件： `动作图`.

### 备注

* 演示场景中仅包含说话和待机动画。不过，可以添加更多动画，并使用角色选择的动作来触发它们。以后会进一步介绍。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/omniverse-extension.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.