管理Agent服务

更新时间：2026-09-20

概述

本文介绍 Agent 服务的查看、编辑、删除、自定义域名绑定与消费者认证管理操作。

进入目标实例的 服务管理 > Agent 服务 查看服务列表，服务较多时可通过名称搜索快速定位。

列	说明
服务名称	服务的唯一标识。单击服务名称可进入服务详情页。
域名数量	服务已绑定的自定义域名数量。
服务域名	服务已绑定的自定义域名列表。
默认域名	服务的默认公网/私网访问域名。仅供测试，网关侧限制单日调用次数不能超过 1000。
关联 API 数量	服务下已创建的 API 数量。
更新时间	服务最近一次的更新时间。
操作	提供「编辑」「删除」入口。

单击服务名称进入服务详情，包含以下标签页：

标签页	内容
基本信息	服务名称、服务 ID、所属网关实例信息、默认域名信息、服务类型等。
自定义域名管理	当前服务绑定的自定义域名列表，支持绑定/解绑。
消费者认证	管理服务级别的消费者认证与消费者绑定。
监控	查看该服务的业务指标与 Token 类 AI 指标，详见Agent 服务监控。

注意：编辑后的配置在保存后即时生效，原有调用方将按新配置访问。

注意：删除服务会同步删除服务下的所有 API。删除后无法恢复，且会立即停止该服务对外的请求处理；WebSocket API 上已建立的长连接会被中断，请谨慎操作。

注意：一个自定义域名只能绑定到一个服务使用。解绑后通过该域名的请求不再路由到此服务。

进入服务详情的 消费者认证 标签页，可对当前服务执行以下操作：

操作	说明
开启消费者认证	打开开关后在弹窗中选择认证方式（API_KEY / AK_SK），确认后开启。开启后该服务下所有 API 的流量默认全部拒绝，仅放行已绑定且启用的消费者。
关闭消费者认证	关闭开关，二次确认提示「关闭后，所有流量将放行，已绑定的消费者不会被删除」。
绑定消费者	认证开启状态下可绑定消费者；未开启认证时绑定入口不可用。
禁用/启用消费者	禁用后该消费者立即失效，原认证凭证将无法调用该服务下的 API；启用后立即恢复。
解绑	解除该消费者与当前服务的绑定关系。

消费者列表展示消费者名称/ID、状态、备注、更新时间与操作列，支持按名称/ID 搜索与按状态筛选。

说明：服务级别的消费者认证对该服务下的所有 API 生效；若某个 API 单独开启了消费者认证，则以 API 侧配置为准，完整的生效优先级说明详见授权管理。