设置智能体

智能体定义功能与职责（“做什么”），涵盖模型、系统提示词、运行环境、工具与Skill等配置项。关联运行环境以保障正常执行。同时支持版本管理。

费用说明

创建并运行智能体将产生以下费用：

模型推理费用（按调用量计费）、运行环境资源费用（按运行时长计费）。如开启日志功能，另产生LTS日志费用。具体计费标准请参考AgentArts计费说明。

约束与限制

每个租户可以创建1000个智能体。

前提条件

已开通AgentArts服务，并在“管理中心 > 授权管理”完成依赖云服务授权。

创建智能体

在Managed Agents页面，选择“智能体 > 创建智能体 > 自定义创建”，配置智能体参数。创建后，智能体显示在智能体列表中，并生成一个版本。默认开启指标监控。

调用智能体产生的指标数据会上报到应用运维管理AOM，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参考AOM计费说明。指标信息可以通过指标预览页面进行查看。

图1 查看指标

图2 创建智能体

基本信息

智能体的基本信息，便于查找、调用和管理。

图3 基本信息

表1 基本信息参数说明
参数	说明
名称	智能体的展示名称，供用户在列表中快速识别与检索该智能体。系统默认生成以agent开头的名称，可以自定义。创建后，不可修改。由2~40个字符组成，包含小写字母、数字和中划线，且必须以小写字母开头、以小写字母或数字结尾。
描述（可选）	智能体的描述信息，帮助用户快速理解该智能体的作用。由0~4096个字符组成。

模型及提示词

图4 模型及提示词

表2 模型及提示词参数说明
参数	说明
模型	智能体使用的模型。默认展示第一个模型。如未配置，请单击“模型管理”，具体请参考模型。不同模型的推理费用不同，请根据业务需求选择合适的模型。
提示词（可选）	定义智能体的角色、行为规则和约束边界。由0~32,768个字符组成。如何写好提示词，请参考提示词。例如，创建一个数据分析智能体时，填写：你是一个数据分析助手，请根据用户提供的数据进行分析并给出结论。

环境

智能体的运行环境。环境是可复用的沙箱/容器模板，定义智能体会话实际执行任务的底层运行载体，回答“智能体在哪里执行任务”。创建环境请参考配置智能体运行环境。

默认展示第一个环境。

图5 环境

工具与Skill

智能体依靠工具做外部操作，依靠Skill封装专业能力。

图6 工具与技能

表3 工具与Skill参数说明
参数	说明
内置工具（可选）	Managed Agents提供了bash、read_file、write_file、edit_file、glob、list_files、grep内置工具，当用户在会话中执行bash命令或文件操作时，为智能体选择内置工具。详细介绍请参考内置工具。
Skill（可选）	最多支持选择50个Skill。需要特定领域能力（如翻译、摘要）时，进行配置。详细介绍请参考Skill。

权限与访问控制

权限与访问控制是智能体运行时的安全底座，约束智能体可以做什么、访问哪些资源、谁可以调用智能体，防止越权、数据泄露、恶意操作。

点击放大

表4 权限与访问控制参数说明
参数	说明
委托	注意：委托权限决定了智能体可访问的外部资源范围。请遵循最小权限原则，仅授予必要的权限，避免因权限过大导致数据泄露或越权操作。授予的代理权限或代理功能，允许代表智能体与外部系统进行通信和交互。为了保证智能体运行时正常运行，所选委托需要具备相关权限。委托创建完成后可对委托进行授权，操作详情请参考创建委托并授权。系统默认值为DefaultAgentArtsRuntimeAgency。说明：使用OBS桶挂载功能时，需为运行时委托配置相应的OBS权限。根据文件系统的访问模式，所需的最小权限如下：文件系统只读操作：obs:bucket:headBucket、obs:bucket:listBucket、obs:object:getObject。文件系统读写操作：obs:bucket:headBucket、obs:bucket:listBucket、obs:object:getObject、obs:object:putObject、obs:object:deleteObject。以上为最小权限要求。如需配置其他权限，请提交工单咨询OBS权限相关事宜。
入网配置	警告：入网配置创建后不可修改。请根据您的网络环境谨慎选择公网访问或VPC内网访问，配置后如需更改需重新创建智能体。通过互联网或者VPC内网访问智能体运行时。更多信息请参考网络配置。系统默认值为defaultgw。公网访问适合需要从外部互联网调用的场景。VPC内网访问适合与VPC内其他云服务内网互通的场景，安全性更高。
入站身份认证	配置入站身份认证方式。在智能体接收到请求时，对请求进行身份验证和授权，确保请求来自可信的来源，并且具有访问特定资源的权限。创建后，不可修改。支持以下认证方式： IAM认证：使用登录管理控制台时使用的IAM用户名进行认证。默认为IAM认证。 OAuth 2.0认证：将OAuth 2.0配置为入站身份认证。选择“OAuth 2.0认证”后，相关参数配置请参考表5。 API Key认证：通过接口的访问密钥进行身份验证和授权。系统会自动生成API Key的名称，可根据需求自定义修改。身份认证凭证在凭据管理服务（DEW）中托管，凭据托管按需计费，费用说明请参考DEW计费说明。选择认证方式可以参考表6。

表5 OAuth 2.0认证参数配置说明
参数	说明
Discovery URL	OAuth发现服务器（OAuth discovery server）只支持公网权威的认证服务器，即服务端证书必须能够校验通过。需输入身份提供商（例如Okta、Cognito等）提供的Discovery URL，该URL通常可在该提供商的文档中找到。输入以https://开头，/.well-known/openid-configuration结尾的有效URL。
JWT授权配置
允许的受众	用于验证OAuth 2.0指定的受众是否与Agent Identity运行时指定的受众匹配，或为其子集。支持添加100个受众。
允许的客户端	用于验证OAuth 2.0指定的客户端标识符是否被允许访问Agent Identity。支持添加100个客户端。
允许的范围	仅当令牌包含此处配置的至少一个必需范围时才允许访问自定义声明。支持添加100个范围。
自定义声明	仅当令牌中的特定声明与预定义字符串值相匹配时才允许访问。支持添加100个自定义声明。

表6 入站身份认证选型对比表
认证方式	适用场景	安全性	配置复杂度
IAM认证	华为云内部用户调用	高	低（默认）
OAuth 2.0认证	第三方系统集成、企业SSO	高	高
API Key认证	简单API对接、开发测试	中	低

可观测配置

Managed Agents提供调用智能体的日志记录功能。

图7 可观测配置

未开启，运行时过程产生的日志无法上报至云日志服务（LTS）。
开启后，运行时过程产生的日志会上报至云日志服务（LTS），日志管理费用按需收取，有关计费相关内容请参考LTS计费说明。默认已开启。

开启后，调用智能体后，可在智能体详情“日志”页签中查看每次调用的输入输出、执行时长、工具调用记录等信息，用于调试智能体行为、排查异常和性能优化。

高级配置

Managed Agents的生命周期配置，用于定义智能体会话存续、休眠到销毁的完整行为规则，管控智能体会话何时启动、保持、重置、回收、终止。控制资源占用、隔离会话状态、确保业务行为可控、避免资源泄漏，保障托管智能体稳定、高效、安全运行。

运行环境按运行时长计费，会话空闲超时和最大存活时间配置直接影响运行费用。

图8 高级配置

表7 高级配置参数说明
参数	说明
会话空闲超时	智能体在一段时间内无用户交互时，自动结束当前会话并释放运行资源，避免持续计费和资源占用。超时后会话终止，用户再次调用时需重新发起。取值范围1~10,080分钟，默认值15分钟。时间越长，会话保持在线越久，资源占用和费用越高，但中断后可无缝续接；时间越短，费用更低，但短暂离开后再回来需重新发起会话。建议按实际使用频率权衡设置。不确定时，建议先用默认15分钟，后续按实际体验调整。
最大存活时间	会话从创建起可存续的最大时长，无论期间是否有交互，到时间后强制结束会话。用于防止会话长期占用资源，控制成本和生命周期风险。取值范围1~168小时，默认值24小时。时间太短，长任务未执行完成即被强制中断，导致结果丢失需重新执行；时间太长，资源占用和费用持续累积。建议按任务最长耗时设置，留有余量即可。