表单或代码创建智能体调试
更新时间 2026-05-11 15:29:00
最近更新时间: 2026-05-11 15:29:00
概述
本章节介绍如何在浏览器页面调试智能体,包括表单创建的智能体和代码创建的智能体。
前置条件
调试智能体需要具备以下条件:
已创建智能体并部署成功
已创建域名,并配置了https证书
调试智能体
表单创建调试智能体
登录智能体引擎控制台,点击左侧导航智能体,选择已经创建好的智能体,点击进入详情页。
点击调试页签。若首次创建智能体,调试页面无法使用,会弹出提示框提示:
配置Default Endpoint(必须绑定HTTPS域名)
凭证配置 匿名访问(前往概览页编辑Agent)
检查是否创建了Default Endpoint。调试时,默认是通过Default Endpoint进行调试,Default Endpoin指向最新的代码与配置。此时,可以点击版本与灰度页签,确认Default Endpoin是否已创建。若已创建,忽略。若未创建,则创建Default Endpoint(见下文)。
检查智能体是否配置了通过凭证访问。点击概览页签,点击权限凭证。若显示匿名访问,忽略。若显示具体的凭证,则点击右侧的编辑,将凭证重新选择为匿名访问,保存。
若以上步骤完毕,可以进入调试。重新点击调试页签,在聊天框输入想问的问题,等待智能体返回。
可以切换模型或者提示词,点击保存并部署,等部署完毕,再次通过聊天框进行调试。或者点击概览页签,点击编辑,根据实际需要修改配置后,重新部署再调试。
可以点击新建会话开启一个新的会话。也可以从历史会话中选择一个已有的会话。
创建Default Endpoint
点击版本与灰度页签,点击创建Endpoint。
填写或选择各项配置,点击确定保存。
| 配置项 | 说明 | 示例 |
|---|---|---|
| Endpint名称 | 同region同租户内,唯一标识一个Endpoint,不超过7个字符。创建Default Endpoint时,名称不可选。 | Default |
| 主要版本 | Endpoint指向的版本。创建Default Endpoint时,版本不可选。 | LATEST |
| 域名 | 选择已经在域名管理创建好的域名,也可以点击创建域名进行创建。 Default Endpoint若用于调试,需要绑定支持HTTPS证书的域名。 | abcd.xxx.com |
| 访问路径 | 支持完整路径或前缀路径 | /openai/v1/chat/completion /abc/* |
| 移除basePath | 为了方便同一个域名可以绑定到不同智能体或者不同Endpoint上,可以通过域名的路径前缀加以区分。 路径重写:仅前缀路径可用,开启“移除BasePath”后,网关转发时,可以去掉前缀。 | 访问路径填写/abc/*, 用户请求路径为/abc/openai/v1/chat/completions,开启“移除basePath”,实际转发到智能体的请求路径为/openai/v1/chat/completions |
| 调试路径 | 在调试页签进行调试时,实际访问的路径。 此处必须是具体的路径,不能是路径前缀。 | /openai/v1/chat/completions |
代码创建调试智能体
代码创建调试智能体与表单创建调试智能体操作方式基本相同。代码创建智能体的实时日志和代码调试功能升级中,敬请期待。