智能体运行时实例操作

instance 命令支持登陆进入活跃实例；包括查看活跃实例列表和对指定实例进行命令行操作

命令解析

当执行命令 instance -h / instance --help 时，可以获取帮助文档。

instance list 命令

instance list 命令，获取智能体运行时目前所有的活跃实例列表。

当执行命令 instance list -h / instance list --help 时，可以获取帮助文档。

参数解析

当前命令支持部分全局参数（例如 -a/--access, --debug 等），详情可参考 Serverless Devs 全局参数文档

操作案例

• 有资源描述文件（Yaml）时，可以直接执行 s instance list 获取实例列表；

上述命令的执行结果示例：

agentrun-instance-test:
  instances:
    -
      instanceId: c-6******9-459adeb5b3994bc1af9e
      versionId:  LATEST
      status:     Running
      createdAt:  2024-01-01T10:00:00Z
    -
      instanceId: c-6******9-693943a10c714137bb12
      versionId:  LATEST
      status:     Running
      createdAt:  2024-01-01T10:05:00Z

instance exec 命令

instance exec 命令，登陆进入指定实例。

当执行命令 instance exec -h / instance exec --help 时，可以获取帮助文档。

参数解析

参数全称	参数缩写	Yaml 模式下必填	Cli 模式下必填	参数含义
region	-	选填	必填	地域名称，取值范围参见函数计算开服地域
function-name	-	选填	必填	智能体运行时名称
instance-id	-	选填	必填	实例 ID
shell	-	选填	选填	自定义 shell，默认 /bin/bash
workdir	-	选填	选填	工作目录
qualifier	-	选填	选填	版本或别名，默认为 LATEST

当前命令还支持部分全局参数（例如 -a/--access, --debug 等），详情可参考 Serverless Devs 全局参数文档

操作案例

• 列出所有实例并选择一个进入：

  s instance list
  s instance exec --instance-id c-6******9-459adeb5b3994bc1af9e
  

• 使用自定义 shell：

  s instance exec --instance-id c-6******9-459adeb5b3994bc1af9e --shell /bin/sh
  

• 指定工作目录：

  s instance exec --instance-id c-6******9-459adeb5b3994bc1af9e --workdir /app --cmd "pwd"
  

权限与策略说明

使用该命令时，推荐配置系统策略：AliyunAgentRunFullAccess