执行命令

使用方式

命令在当前工作目录执行，可选设置秒数超时；不提供 timeout 时没有默认超时。面向模型的输出保留最后 2000 行或 50KB，发生截断时完整输出保存至临时文件。非零退出码会标为错误结果；超时或中止也会明确报告。

在对话中描述需求，由 Agent 决定是否调用。以下是 Agent 工具参数，不是公开 HTTP API。

输入参数

调用示例

用命令输出一条简单文本，并设置 10 秒超时。

{
  "tool": "bash",
  "arguments": {
    "command": "printf 'Study Agent\\n'",
    "timeout": 10
  }
}

示例仅用于说明结构，不会在浏览此页时执行。

返回结果

返回合并的 stdout 与 stderr，必要时附带截断提示及完整输出临时文件位置。结构化结果包含 output、truncated、exit_code、wall_time_seconds，并在相应截断条件下提供 full_output_path。

执行范围与限制

• 面向模型的输出只保留最后 2000 行或 50KB，以先达到者为准。
• 程序化结构化 output 上限为 1MiB，不应与面向模型的输出上限混淆。
• 命令受云端操作系统权限约束；不能据此访问用户电脑。
• 工作目录不存在、超时、中止或命令非零退出都不能视为执行成功。