抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 组件概述
  • 基础内容
  • 视图容器
  • 表单
  • 导航
  • 媒体
  • 画布
  • 地图
  • 开放能力
  • 行业开放
  • 原生组件
  • 拓展组件
  • 小程序智能体
  • ai-agent-chat AI会话组件
  • ai-agent-chat AI会话组件

    收藏
    我的收藏

    基础库 3.74.0 开始支持本组件

    小程序智能体会话流组件

    前提条件

    需要用户授权剪贴板权限,否则无法实现复制消息功能。

    业务背景
    使用限制

    使用本能力前请前往 小程序智能体概述 查看接入指引,未接入的小程序无法使用本能力。

    注意事项
    相关教程

    https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/tutorial/open-capabilities/ai-agent/ai-session-api-guide

    属性说明

    属性名类型默认值必填说明最低支持版本
    agent-idstring
    智能体ID
    3.74.0
    agent-versionstring
    智能体版本
    3.74.0
    modeenumonline
    运行模式
    3.74.0
    bindloadedfunction

    组件加载成功事件

    3.74.0
    binderrorstring

    组件错误事件,详细错误见错误码

    3.74.0

    mode 的合法值

    说明最低支持版本
    online
    线上模式
    3.74.0
    preview
    预览模式
    3.74.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    183001value of agent-id or agent-version cannot be emptyD
    3.74.0
    183002network unavailableU
    3.74.0
    183003not loginU
    3.74.0
    183004internal errorF
    小程序框架内部错误,有需要请创建工单咨询
    3.74.0
    183005internal errorF
    小程序框架内部错误,有需要请创建工单咨询
    3.74.0

    代码示例

    智能体组件引入
    <view tt:if="{{fallback}}">当前版本过低,请升级应用版本后使用</view> <ai-agent-chat tt:else agent-id="ttbc02cabf230bd48016" mode="preview" agent-version="1.21.0"></ai-agent-chat>
    兼容处理
    Page({ data: { fallback: false, }, onLoad: function () { const canIUse = tt.canIUse('ai-agent-chat'); this.setData({ fallback: !canIUse }) }, })