
# 错误码
当您调用API时，如果遇到"APIGW"开头的错误码，请参见[API网关错误码](https://support.huaweicloud.com/devg-apisign/api-sign-errorcode.html)进行处理。
| 状态码 | 错误码                | 错误信息                                                                                          | 描述                                                                                                                                                 | 处理措施                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|:---|
| 400 | AgentArts.03001001 | Input parameter is invalid                                                                    | 输入参数无效。                                                                                                                                            | 请检查输入参数是否正确。                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 400 | AgentArts.03002106 | Operation failed                                                                              | 外部知识库不支持文件下载。                                                                                                                                      | 第三方知识库连接不存在。                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 400 | AgentArts.03003039 | Operation failed                                                                              | 未找到图片或图片已过期。                                                                                                                                       | 请稍后重试。                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 403 | AgentArts.03001021 | Operation failed                                                                              | 下载的文件为空。                                                                                                                                           | 请检查并重试。                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 404 | AgentArts.03001003 | resource not exist                                                                            | 资源不存在。                                                                                                                                             | 请联系技术支持。                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 404 | AgentArts.03002010 | Can not retrieve in knowledge base                                                            | 这些知识已被删除或关闭。                                                                                                                                       | 请检查这些知识的状态。                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 500 | AgentArts.03000000 | System internal error                                                                         | 系统内部错误。                                                                                                                                            | 请联系技术支持。                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 500 | AgentArts.03002019 | Operation failed                                                                              | 未找到该文件或该文件已过期。                                                                                                                                     | 请检查后再重试。                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 500 | AgentArts.03002104 | Query third party knowledgeBases error                                                        | 第三方知识库连接信息错误。                                                                                                                                      | 请检查连接信息后重试。                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 200 | AgentArts.02101016 | Insufficient execution permissions for Agent.                                                 | 当前用户无权在指定项目中运行该单智能体应用                                                                                                                              | 请确认当前用户在目标项目中拥有该单智能体应用的执行权限                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 200 | AgentArts.100002   | Parameter validation failed                                                                   | 输入参数格式不正确或缺少必要参数                                                                                                                                   | 请检查请求参数是否符合接口规范                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 400 | AgentArts.02101032 | Current Agent version does not exist                                                          | 请求中指定的Agent或其版本在系统中不存在，可能已被删除或未正确发布                                                                                                                | 请确认Agent ID和版本信息是否正确，并确保该Agent已成功发布并可用。                                                                                                                                                                                                                                                                                                                                                                                                           |
| 401 | APIG.0301          | Incorrect IAM authentication information.                                                     | IAM身份验证信息不正确： decrypt token fail：token解析失败。 token expires：token过期。 verify aksk signature fail：AK/SK认证失败。 x-auth-token not found：未找到x-auth-token参数。 | token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 token超时（token expires） ，请重新获取token，使用不过期的token。 请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。 检查账号权限，是否欠费，被冻结等。 检查调用API时，请求header参数X-Auth-Token是否拼写正确。 |
| 401 | common.01010018    | Auth token failed                                                                             | 不正确的token信息，token解密失败                                                                                                                              | 请检查输入的x-auth-token是否正确                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 403 | AgentArts.02001017 | API call count for Agent exceeds quota.                                                       | 智能体API调用次数已用完。                                                                                                                                     | 请升级套餐。                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 403 | AgentArts.02201020 | Insufficient workflow execution permissions.                                                  | 当前执行请求的projectId与工作流所属projectId不一致。                                                                                                                | 请确保当前空间中的projectId与工作流所属的projectId一致。                                                                                                                                                                                                                                                                                                                                                                                                             |
| 404 | AgentArts.02101007 | Agent does not exist.                                                                         | 请求的智能体应用未找到或已被删除。                                                                                                                                  | 请确认该应用是否存在。                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 404 | APIG.0101          | The API does not exist or has not been published in the environment.                          | 访问的API不存在或尚未在环境中发布。                                                                                                                                | 请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。 HTTP请求方法（POST，GET等）是否正确。                                                                                                                                                                                                                                                                                                                                                   |
| 429 | APIG.0308          | The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute. | 发送请求超过了服务的默认配置限流。                                                                                                                                  | 通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求。 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。                                                                                                                                                                                                                                                                                                                               |
| 500 | AgentArts.02201004 | Workflow or workflow version does not exist.                                                  | 请求中指定的工作流ID在当前项目和工作区中不存在，可能已被删除或未正确创建。                                                                                                             | 请确认工作流ID是否正确，并确保该工作流在当前项目和工作区中已存在。                                                                                                                                                                                                                                                                                                                                                                                                                |
| 504 | APIG.0201          | Backend timeout.                                                                              | 请求超时。                                                                                                                                              | 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。                                                                                                                                                                                                                                                                                                                               |
   
