开发界面介绍

本文档旨在为开发者介绍小艺开放平台中，智能体在LLM模式（单Agent模式） 下的核心开发界面。该界面是开发者进行智能体设计、配置、调试与测试的一站式工作台。

如图所示，开发界面主要划分为三大功能板块，从左至右依次为：编排功能区、角色指令区、调试与预览区。此外，界面最左侧的侧边栏还提供了Agent级别的全局配置与管理入口。其他编排模式（如云工作流模式、云A2A模式）的特殊设置，请参考对应的专项开发文档，本文档不作重复阐述。

全局配置（左侧边栏）

左侧边栏是智能体的管理中枢，提供以下核心配置入口：

• 编排：当前主配置区，即本文档重点介绍的三大功能板块。
• 配置（或称为“选项”）：包含智能体的基础信息、发布设置等。
• 测试白名单：用于在智能体上架前，指定特定用户或设备进行内部测试。
• 运营看板：展示智能体的使用数据、调用量、用户反馈等运营指标，帮助开发者分析智能体表现。

Agent配置

创建Agent后，开发者从左侧边栏点击配置，进入Agent配置页面对Agent的基础信息、隐私协议服务、内容合规进行编辑。

基础信息

支持编辑图标、名称、一句话描述、支持的设备和系统、创建者昵称、智能体分类、智能体别名、文件存储类型、AgentCard。

图标：上传的图标建议比例1:1正方形图片，大小不超过5M，支持png、jpeg、jpg不透明背景。

智能体名称：支持编辑智能体名称，智能体名称为必填项，不能编辑为空。

智能体分类：开发者可根据智能体能力选择适合的智能体分类。

支持的设备和系统：开发者可编辑智能体支持的设备和系统，支持多选。（HarmonyOS NEXT为设备系统ROM版本5.X以上，HarmonyOS为设备系统ROM版本4.X）

创建者昵称：不配置默认为此账号设置的创建者昵称（查看方式：点击头像-账号设置-创建者昵称）；企业开发者也可选择已创建并通过审核的创建者昵称。

一句话描述：开发者可根据智能体的实际功能对智能体进行描述，描述会直接显示在智能体的详情页内展示给用户查看。

智能体别名：用于智能体分发，提高分发准确率，支持配置多个别名。

AgentCard：AgentCard相当于智能体的“名片”，用户描述智能体的能力和技能。主要用于小艺主对话分发智能体，可支持部分字段编辑。AgentCard字段会根据智能体当前的基础信息与配置的插件与工作流配置自动同步生成，同时支持新增和编辑AgentCard中的能力，可编辑功能名称、功能描述、依赖项。

典型字段如下：

自动同步字段	子项	可编辑	描述
智能体名称	—	否	—
智能体ID	—	否	—
智能体版本	—	否	—
智能体描述	—	否	—
输入类型	—	否	同步自智能体输入文件设置，多选值；可以包含 字符串、文件、图片。
输出类型（默认为字符串）	—	否	预留字段，默认为字符串。
智能体功能（功能同步自智能体插件与工作流）	—	是	智能体功能列表，支持新增、编辑、删除列表中的智能体功能。
—	功能名称	是	同步自插件的工具名称和工作流名称。
—	功能描述	是	同步自插件的工具描述和工作流描述。
—	依赖项	是	同步自能力依赖的端插件，云插件无依赖项。

隐私协议服务

Agent发布上架时，您需要提供隐私政策，以便用户了解Agent的数据收集和使用情况；支持选择自定义隐私政策，或者使用平台隐私声明托管服务生成的隐私协议。

说明

如果您已有描述隐私政策和用户隐私权利的隐私网址：在智能体【配置】-【隐私协议服务】页面，隐私声明处选择“自定义隐私政策”，在隐私政策网址中直接填写隐私网址，无需参考本章节进行隐私声明托管。

通过平台提供的隐私声明托管服务基于标准化模板生成自己的隐私协议。

注意

• 请如实填写，当用户个人信息处理或敏感权限调用等场景发生变动时，请及时更新隐私声明。如实际情况与本声明中内容不符，您将承担由此产生的法律责任及风险。
• 每个智能体可配置多个隐私协议，但上架时仅能关联1个隐私协议。

步骤一：新建隐私协议

可以通过【配置】-【隐私协议服务】页面，在隐私声明处选择“隐私托管”，点击【协议服务】，跳转到智能体配置-隐私协议服务页面，点击【新建协议】创建。

也可以直接通过智能体【配置】-【隐私协议服务】页面，点击【新建协议】创建。

点击新建协议后，在弹出窗口中填写“协议名称”，点击“创建”后，开始编辑隐私协议。

步骤二：编辑隐私协议

完整协议包含多块内容，您需要逐个配置完成，在配置过程中，您可以随时点击右上方的“保存”按钮保存已填写内容。

导语部分

导语内容模板比较固定，提供如下信息：

智能体介绍：简单介绍智能体提供的功能。

重要提示或版本变更说明：描述协议相对上个版本的变更点或重要提示点。

“我们如何收集和使用您的个人信息”部分

“我们提供下列服务时会处理必要的个人信息”：提供服务时会处理的个人信息项说明，默认收集用户对话信息；若涉及其他数据项，可通过“新增数据信息”添加，添加后填写“个人信息采集用途”、“前提条件”以及补充说明（补充说明可选）。

“个性化推荐说明”（可选）：仅当向用户推送个性化推荐内容时，需要声明；可通过“新增数据信息”添加。

“对未成年人的保护”部分（可选）

声明对未成年人的保护政策；点击“增加对儿童保护声明”，生成对应声明模板，在模板中填写儿童隐私保护声明链接，以及补充说明（补充说明可选）。

“与第三方共享”部分（可选）

如果涉及将用户个人信息提供给第三方，则需要对三方共享信息进行声明。点击“增加三方共享信息声明”，生成对应声明模板，填写共享数据的第三方公司的信息；如果将数据共享给多个第三方，点击“增加三方共享信息声明”，继续增加其他第三方共享信息说明。

“第三方MCP Server”部分（可选）

如果涉及将用户个人信息提供给第三方MCP Server，则需要对三方MCP Server共享信息进行声明。点击“新增MCP Server信息”，生成对应声明模板，填写共享数据的第三方MCP Server的信息；如果将数据共享给多个第三方，点击“新增MCP Server信息”，继续增加其他第三方MCP Server共享信息说明。

“管理您的个人信息”部分

固定内容，不可修改

“信息存储地点及期限”部分

说明对用户信息的存储期限、存储位置。

设置个人数据存储期限：

• 固定存储期限：填写信息会存储的具体时间。
• 非固定存储期限：承诺保存期限为实现处理目的所必要的最短时间。

存储位置：固定为中国境内的服务器。

“开发者自定义章节”部分（可选）

如果有其他涉及用户利益、需要提示的事项或者免责说明，在本模块进行说明。

“如何联系我们”部分

提供用户联系您的方式。点击“增加商业联系方式”添加，可以配置电话、邮箱和公司地址三种联系方式。

“隐私政策生效日期”部分

设置当前隐私政策的生效日期。

步骤三：预览隐私协议

所有内容编辑完成，可以点击右上角“预览”查看协议生成效果。

步骤四：生成隐私协议

隐私协议配置完成后，点击【生成协议】，生成后的隐私协议状态为“完成”，完成状态的协议可供Agent上架时关联。

保存后的隐私协议可通过“编辑”修改协议内容，编辑后需再次点击【生成协议】完成协议更新。

FAQ

问题1：智能体选择隐私托管的隐私协议后，有错误提示？

回答：智能体关联托管的隐私协议后，平台会自动检测智能体编排涉及隐私相关项与选择的隐私协议中隐私相关项是否一致，若不一致会提示开发者补充，可通过点击“查看更新后的隐私协议”查看具体问题项。

点击“查看更新后的隐私协议”后，可以通过“编辑原文”在原协议中补充，也可以点击“继续使用”新建一个“修改后（自动生成）”的协议，然后点击“生成协议”更新或生成新协议供智能体上架时关联。

问题2：平台创建的隐私协议已修改并保存，上架后选择的仍是旧版隐私协议？

回答：协议生成后，若发生编辑，需再次点击“生成协议”完成协议更新。

内容合规

应国家法律规定和网信办合规要求：《生成式人工智能服务管理暂行办法》、《互联网信息服务深度合成管理规定》、《人工智能生成合成内容标识办法》、《国家互联网信息办公室关于发布生成式人工智能服务已备案信息的公告》，智能体上架前，需完成“人工智能生成合成内容标识”和“大模型备案信息”填写 ，以供平台审核；相关信息可在智能体【配置】-【内容合规】中填写。

人工智能生成合成内容标识：“人工智能生成合成内容标识”填写智能体是否涉及人工智能生成的内容，开发者需按照国家法律规定如实在这里填写申报。

填写项	说明
是否包含人工智能生成合成内容文件	结果中是否包含AI生成合成内容，如文本文件、图片、音频、视频、虚拟场景等；若包含选择“是”，否则选择“否”。
AI生成文件	涉及AI生成合成内容文件时必填，根据实际勾选对应AI生成文件类型，并填写人工智能生成合成内容标识。
人工智能生成合成内容标识	请仔细阅读相关规定后勾选。

“是否包含人工智能生成合成内容文件”选择“是”时需填写人工智能生成合成内容标识。人工智能生成合成内容标识详情可参考《人工智能生成合成内容标识方法》。

填写项	说明
生成合成标签 (Label)	存储内容属于、可能、疑似为人工智能生成合成的属性信息：属于人工智能生成合成内容的，值取1；可能为人工智能生成合成内容的，值取2；疑似为人工智能生成合成内容的，值取3。
生成合成服务提供者 (ContentProducer)	存储生成合成服务提供者的名称或编码。
内容制作编号 (ProducerID)	存储生成合成服务提供者对该内容的唯一编号。
预留字段1 (ReservedCode1)	可存储用于生成合成服务提供者自主开展安全防护、保护内容、标识完整性的信息。
内容传播服务提供者 (ContentPropagator)	存储内容传播服务提供者的名称或编码。
内容传播编号 (PropagatorID)	存储内容传播服务提供者对该内容的唯一编号。
预留字段2 (ReservedCode2)	可存储用于内容传播服务提供者自主开展安全防护、保护内容、标识完整性的信息。

大模型备案信息：开发者如果在智能体中接入了非小艺开放平台提供的三方大模型，需在此处申报备案，多个备案号使用英文逗号分隔。生成式人工智能服务上线备案号查询：登录《国家互联网信息办公室关于发布生成式人工智能服务已备案信息的公告》查询、算法备案号查询：登录《互联网信息服务算法备案系统》查询。

本文配套模板、静态源码可前往艾立兹素材库alisucai.com下载