团结AI Assistant 使用指南

团结AI Assistant（原名 团结Muse Chat）是 团结AI 的首个开放的功能（内测中）。

无论您在编写代码、设计游戏场景，还是进行性能优化时遇到问题，只需向 团结AI Assistant 提问，即可获得及时、精准的解答。

界面示例

团结AI Assistant 的基础功能窗口如下图所示：


(1) 状态栏	显示窗口名称、用户名称缩写（登录状态下），以及每日使用余额。
(2) 侧边栏	记录历史会话，支持新建、选择、删除、重命名和清空会话，并提供反馈问卷入口。
(3) 会话区	展示当前会话消息。
(4) 输入区	输入/发送问题、停止回答/重新生成；支持深度思考、联网搜索、Agent 模式、添加代码附件等多种扩展设置。

开始使用

入口位置

主菜单入口路径： Window > Tuanjie AI Assistant

如果没有登录 Unity ID 账号，窗口界面会如下显示。点击窗口中的“登录”按钮，将自动跳转到登录页面。登录完成后将自动跳转到会话页面。

快捷入口功能

快捷调试入口：在 Console 面板中，右键报错信息，即可直接向 团结AI Assistant 提问。

快捷生成入口：在 Hierarchy 或 Project 面板中，右键 GameObject 或 Asset，选择 Tuanjie AI > Generate Script 或 Tuanjie AI > Generate Shader。

将弹出生成窗口，输入需求即可快速生成：

高级功能

网络搜索与深度思考

网络搜索启用后，系统可获取实时网络信息并阅读您提供的网页。

深度思考启用后，系统后端会接入思考模型，并在回答中展示思考过程，如下图所示：

网络搜索和深度思考都默认启用。您可以点击上图中相应的按钮改变启用状态。

Agent 模式

默认启用 Agent 模式。在该模式下，团结AI Assistant 会根据具体情况选择合适的 Agent 工具进行调用，以便更好地分析当前项目，自动化操作流程，从而提升回答的质量。所有获取的信息仅用于当前问题回答，不会参与数据训练。

如下图所示，将鼠标移动至输入框左侧的机器人图标，Agent工具列表 会自动弹出。您可选择是否启用列表中的每项工具。

团结AI Assistant 内置了一套 Agent 工具集，它们可以读取当前项目中的各种资源，向 LLM 提供丰富的上下文信息。下表概括了每项内置工具的名称和用途：

工具名称	用途
场景信息获取	获取当前场景 Hierarchy 中所有 GameObject 的信息
资产信息获取	获取当前工程的 `Assets/` 目录下的所有资产文件数据
属性信息获取	获取指定资产的 Inspector 面板信息
项目设置信息获取	获取当前工程的项目设置信息
偏好设置信息获取	获取当前工程的偏好设置信息
文件内容获取	获取指定路径下的文件内容

您也可以添加自定义的 Agent 工具。点击 Agent工具列表 的右上角的“+”号图标，跳转到 创建Agent工具 弹窗，界面如下所示：

下表概括了弹窗中每个表项的名称和描述：

表项名称	描述
显示名称	显示在工具列表中的名称
工具名称	工具的唯一标识符，建议采用蛇形命名法
工具描述	功能描述，供 LLM 参考，以便决定何时调用该工具
参数名称	参数的唯一标识符，建议采用蛇形命名法
参数类型	参数的类型。目前支持5种选择：字符串（String）、整型（Int）、单精度浮点型（Float）、布尔类型（Boolean）和列表类型（List）
参数描述	参数含义描述，供 LLM 参考，以便决定传递什么实参
工具脚本	工具被执行时所调用的 C# 脚本文件

点击“保存工具”之后，您的自定义工具信息会序列化成.agtdef格式的文件，保存在Assets/TuanjieAIAgentTools/目录下。 团结AI Assistant 会自动探测该目录下所有的.agtdef文件，并同步更新到 Agent工具列表。

自定义工具的执行逻辑需要您来实现。点击“创建”可自动生成 C# 脚本模板，相应的代码文件默认保存在Assets/TuanjieAIAgentTools/目录下。自定义工具的类必须实现IAgentToolExecutor接口，该工具的调用入口是Execute()方法，实参通过一个字典toolInput传入。下面的实例代码展示了自定义工具的基本代码架构，以及不同类型参数的获取方式：

using UnityEngine;
using TuanjieAI.Assistant.Toolbox;
using System.Collections.Generic;

// 自定义工具的类必须实现 IAgentToolExecutor 接口
public class SomeTool : IAgentToolExecutor
{
    public string Execute(Dictionary<string, object> toolInput)
    {
        // 获取字符串类型实参
        var someStringParam = (string)toolInput["some_string_param"];

        // 获取整型实参
        var someIntParam = (int?)toolInput["some_int_param"];

        // 获取浮点型实参
        var someFloatParam = (float?)toolInput["some_float_param"];

        // 获取布尔类型实参
        var someBoolParam = (bool?)toolInput["some_bool_param"];

        // 获取列表类型实参
        var someListParam = toolInput["some_list_param"] as List<object>;

        // 在下方编写这个工具的具体逻辑
        // ...

        return "Success!";
    }
}