
# 使用前必读
欢迎使用AgentArts服务。AgentArts是一个企业级一站式智能体构建与运营平台。它打破了传统开发壁垒，支持Agent开发人员通过可视化、低代码的方式，快速搭建从简单助手到复杂业务流的各类AI应用。
您可以使用本文档提供API对AgentArts进行相关操作，如调用运行时等。支持的全部操作请参见[API概览](https://support.huaweicloud.com/api-agentarts/agentarts_07_0002.html)。
在调用AgentArts API之前，请确保已经充分了解AgentArts相关概念，详细信息请参见[产品介绍](https://support.huaweicloud.com/productdesc-agentarts/agentarts_03_0002.html)。
 #### 终端节点
终端节点即调用API的**请求地址**，不同区域的终端节点不同，AgentArts请求地址获取方法如下。
表1接口域名 
| 类型      | 子类型                                                                                                                                                              | 域名                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| 工作流/智能体 | [工作流/智能体](https://support.huaweicloud.com/api-agentarts/topic_300000000_3.html)                                                                                  | 1. 进入AgentArts智能体平台，在左侧菜单栏选择"智能体管理"，选择"工作流"或者"智能体"。  2. 鼠标移动至待运行的智能体/工作流卡片上，单击"调用路径"。  3. 在弹出的卡片中，复制运行时名称，如[图1]所示。 图1获取运行时名称 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002716264365.png "点击放大")   4. 在左侧导航，选择"智能体运行时"。  5. 在搜索框内输入[3]获取的运行时名称，单击搜索。  6. 单击运行时名称，进入详情页面，在"最新版本配置详情"区域，查看获取"访问域名"，访问域名即为API的请求地址。 图2获取访问域名 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002581395611.png "点击放大")    |
| 运营运维    | [观测](https://support.huaweicloud.com/api-agentarts/agentarts_07_0011.html)                                                                                       | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 运营运维    | [评估](https://support.huaweicloud.com/api-agentarts/agentarts_07_0022.html)                                                                                       | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 智能体运行时  | [代码解释器管理](https://support.huaweicloud.com/api-agentarts/topic_300000000_1.html)                                                                                  | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 智能体运行时  | [代码解释器标签管理](https://support.huaweicloud.com/api-agentarts/topic_300000001_1.html)                                                                                | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 智能体运行时  | [网关](https://support.huaweicloud.com/api-agentarts/agentarts_07_0028.html)                                                                                       | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 智能体运行时  | [记忆库](https://support.huaweicloud.com/api-agentarts/agentarts_07_0030.html)                                                                                      | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 智能体运行时  | [运行时](https://support.huaweicloud.com/api-agentarts/topic_300000001_6.html)\~[运行时访问方式标签管理](https://support.huaweicloud.com/api-agentarts/topic_300000006_2.html) | **agentarts.cn-southwest-2.myhuaweicloud.com**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 智能体运行时  | [智能体运行时执行（高代码）](https://support.huaweicloud.com/api-agentarts/topic_300000000_6.html)                                                                            | 1. 在左侧导航，选择"智能体运行时"。  2. 在搜索框内输入[智能体运行时的名称](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_031.html)，单击搜索。  3. 单击运行时名称，进入详情页面，在"最新版本配置详情"区域，查看获取"访问域名"，访问域名即为API的请求地址。 图3获取访问域名 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002550799898.png "点击放大")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 智能体运行时  | [代码解释器数据面接口](https://support.huaweicloud.com/api-agentarts/topic_300000007.html)                                                                                 | 1. 在左侧导航，选择"开发中心 \> 组件库"，单击"沙箱工具"页签，进入沙箱工具界面。  2. 在搜索框内输入沙箱工具名称，单击搜索。  3. 单击沙箱工具名称，进入详情页面，在"配置信息"页签，查看获取"域名"，域名即为API的请求地址。 图4获取访问域名 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002577862922.png "点击放大")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
#### 基本概念
- 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。
  
- 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。
  在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
  
- 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。
  详情请参见[区域和可用区](https://support.huaweicloud.com/usermanual-iaas/zh-cn_topic_0184026189.html)。
  
- 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
  
- 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。
  图5项目隔离模型   
  ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002445448909.png "点击放大")
  同样在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)下，您可以查看项目ID。
  
- 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。
  关于企业项目ID的获取及企业项目特性的详细信息，请参见《[企业管理服务用户指南](https://support.huaweicloud.com/usermanual-em/em_am_0006.html)》。
  
 
