调用智能体运行时

前提条件

在调用智能体运行时前，须确保已部署智能体运行时，具体请参考部署智能体运行时。

获取访问域名

1. 登录AgentArts智能体开发平台。
2. 在左侧导航栏选择“部署运行 > 智能体运行时 ”。
3. 在列表单击已创建好的智能体运行时名称，进入智能体运行时详情页。
4. 在“基本信息”区域即可查看“访问域名”。
   图1 获取访问域名
   

智能体运行时实例健康检查

用于检测智能体运行时实例是否正常运行。

系统会默认使用智能体运行时配置的协议（如HTTP）和监听的端口（如8080）来发送探活请求，检查实例是否响应。也可以通过自定义的健康检查接口，通常为HTTP GET请求，路径为 /ping来定义更具体的健康检查逻辑。

示例如下：

• @app.ping
  注册健康检查处理函数，处理 /ping端点的请求。

  from agentarts.sdk.runtime.model import PingStatus
  
  @app.ping
  def health_check() -> PingStatus:
      """自定义健康检查"""
      if is_healthy():
          return PingStatus.HEALTHY
      else:
          return PingStatus.UNHEALTHY

  表1 PingStatus状态值

  状态	说明
  HEALTHY	服务健康，无正在执行的任务。
  HEALTHY_BUSY	服务健康，有任务正在执行。
  UNHEALTHY	服务不健康。

  强制设置状态

  # 设置维护模式app.force_ping_status(PingStatus.UNHEALTHY)  # 恢复正常app.force_ping_status(None)

如若未实现/ping接口，服务在进行健康检查时接收到HTTP状态码为404的响应，同样视为健康检查通过。

当智能体执行后，服务每隔5秒向运行时实例发送一次健康检查请求，如果健康检查异常，服务端会认为运行时实例异常，将终止此实例。

健康检查请求的超时时间是1秒，如果连续3次健康检查请求未响应或者返回为Unhealthy状态，运行时实例将被终止。

使用API调用智能体运行时

使用API调用智能体运行时的操作，请参考调用智能体运行时。