# AI应用技能
# 概述
技能是七巧与智能体平台的数据交流载体。七巧通过技能调用智能体平台的智能体,并基于智能体输出为七巧业务赋予智能化。 AI助手必须关联技能才能正常使用
# 前提条件
需要具备AI功能。如果您使用AI功能时,系统提示您当前版本不包含AI功能或功能过期时,请联系道一商务。也可以点击右下角的【在线咨询】咨询客服。
# 功能说明
# 新增技能-调用智能体
进入“应用内部-AI设计-技能”,点击【添加】按钮,打开添加弹窗。
以下是技能具备配置说明: 1、基本信息
技能的基本信息
技能名称:技能的名称,可以与其他技能重名。最大30字。
技能id:提交后自动生成,无法修改。
技能图标:支持线性、面性图标,也支持上传自定义图标。
技能类型:目前只有一种“调用智能体”,即说明该技能与某个智能体关联绑定。一个技能就对应一个智能体。
技能描述:技能的备注,帮助管理员了解该技能的用途。
2、调用智能体
基于不同智能体平台,展示不同技能参数。具体参数值详见各平台的集成说明。
3、快速填写 用户通过“快速填写”,可以快速改动技能的输入设置和输出设置。相当于一种参数模板。 用户点击不同选项,技能的输入和输出配置就会跟随改动。但用户仍可以在改动后的参数继续修改。
自定义:初始默认配置。自由配置。
智能问答:让技能变为“智能问答”玩法。即用户与AI一问一答,是最通用和常见的场景。
智能填单:让技能变为“智能填单”玩法。即七巧会基于智能体输出,将输出值填充到表单字段里。
智能问数:让技能变为“智能问数”玩法。即七巧会基于智能体输出的SQL,执行SQL并渲染成基础报表图表。
4、输入设置-智能体输入参数 为了确保智能体的业务得到足够的参数,部分智能体会要求入参特定内容。即除了聊天输入框的消息,还需要填写一份参数表,智能体才会启动。 例如,生成小红书文案时,智能体会要求必须传入文案主题、关键词等参数。
因此,为了配合智能体的入参,技能也需要配置“智能体输入参数”。即,该份参数必须与智能体的输入参数保持一致。
例如:dify平台的智能体,开始节点配置了三个参数。那技能也必须配置同样参数名的参数。
5、输入设置-输入类型 输入类型决定七巧将哪些数据传给技能关联的智能体。 1)表单字段:当在用户端(运行平台)的表单使用该技能时,七巧能获取表单字段结构和字段值,并传给智能体。同时,也会将提示词一并传给智能体。智能体就能基于表单结构和字段值进一步处理。 2)提示词:七巧只会将提示词字段的内容传给智能体。不会传表单字段。
提示词:智能体有自身的提示词。技能的这份提示词更多用于补充说明,帮助智能体获取更多信息。可填可不填。
6、输出设置-输出展示类型
七巧AI技能的核心配置。用于规定技能接收到智能体输出后,应该如何展示给用户。
1)智能问答:输出内容以markdown、代码等图文格式展示。支持图文回复。支持展示代码块。
2)智能填单:输出内容以填单卡片展示。用户可以选择全自动填充、全自动插值。填充是覆盖型填充,插值是针对多选字段插入新值。
3)智能问数:输出内容以问数卡片展示。七巧会根据智能体输出的SQL查询数据,然后渲染成明细表、柱状图、条形图、饼图。注意:SQL的数据查询权限以表单的数据过滤的默认模板为准!
7、输出设置-输出处理类型
技能接收到智能体输出后,应该如何处理数据。
1)表单字段赋值:在用户端(运行平台),如果在表单位置(添加弹窗、编辑弹窗等)使用该技能,那技能接收到智能体输出后,会尝试将输出值自动填充到表单字段。一般而言,只有“智能填单”场景需要勾选该选项。
2)无:不处理。技能接收到智能体输出后,单纯展示。
# 编辑技能-调用智能体
点击【编辑】,打开编辑弹窗,可以编辑修改技能相关信息。
开启/关闭技能
开启技能:技能可以被正常调用。
关闭技能:所有使用/关联该技能的地方,看不到该技能。
删除技能 删除技能。删除时,会校验技能是否被关联。如果技能被助手等功能关联了,需要去那边删除关联后才能删除技能。
复制技能
复制并新建技能。完整复制该技能的配置,新建一个新技能。
# 技能使用权限
可以控制哪些用户能看见和使用该技能。如果用户不在权限范围内,那用户在AI应用助手里,会看不到该技能。 1、全部可见 全部用户都可以使用该技能。
2、部分可见
添加通讯录的用户、部门。添加角色进入可见范围。
导出设置
导出应用时,如果需要将智能体技能参数的值一并导出,可以开启允许敏感数值导出。
如果只想导出技能其他配置,不想导出智能体参数,可以禁止导出值,只导出技能其他内容,例如基本信息、输入输出内容等。