Aether 请求证据室 tool call、agent loop 与 steer 的完整链路

同一轮同时有 assistant content 和工具调用

client_response_body.choices[0].message.content 长度 68，同时 tool_calls[0].function.name = astrbot_execute_shell，finish_reason = tool_calls。

复制{
  "finish_reason": "tool_calls",
  "message": {
    "role": "assistant",
    "content": "确认到插件常见结构啦。现在创建到 /AstrBot/data/plugins 下...",
    "tool_calls": [
      {
        "id": "call_d22h4bpSmyiw5g8ac8Sit36b",
        "type": "function",
        "function": {
          "name": "astrbot_execute_shell",
          "arguments": "{\"command\":\"mkdir -p ...\"}"
        }
      }
    ]
  }
}

只有工具调用，没有中间文字

同样是工具调用轮次，但 client_response_body.choices[0].message.content = null， 因而 UI 没有 assistant 文本可显示。

复制{
  "finish_reason": "tool_calls",
  "message": {
    "role": "assistant",
    "content": null,
    "tool_calls": [
      {
        "function": {
          "name": "astrbot_grep_tool",
          "arguments": "{\"pattern\":\"@filter.command\",...}"
        }
      }
    ]
  }
}

Gemini 第一轮只返回 functionCall

response_body.candidates[0].content.parts[0].functionCall 存在；同一 part 没有 text。 这就是 Gemini 中间步骤不是 assistant content 的直接证据。

复制{
  "finishReason": "STOP",
  "parts": [
    {
      "functionCall": {
        "name": "ltm_memory_search",
        "args": { "query": "2026-05-20 虹云彼方 蓝狗" },
        "id": "01p5ltji"
      }
    }
  ]
}

下一轮回填 functionResponse 后产生最终文本

请求体 contents[2] 是上一轮 role=model functionCall，contents[3] 是 role=user functionResponse。响应才出现最终 text。

复制{
  "contents": [
    "...",
    {
      "role": "model",
      "parts": [{ "functionCall": { "name": "ltm_memory_search", "id": "01p5ltji" }}]
    },
    {
      "role": "user",
      "parts": [{ "functionResponse": { "name": "ltm_memory_search", "response": { "data": "..." }}}]
    }
  ]
}

OpenAI 链每轮带完整 30 个工具

request_body.tools.length = 30。实际本任务常用 astrbot_execute_shell、 astrbot_execute_python、astrbot_file_read_tool、astrbot_file_write_tool、 astrbot_grep_tool。

Gemini 单工具链与 8 工具 LTM 链

5928d8ae 和 c82cd63a 的 functionDeclarations 只有 ltm_memory_search； 同窗口 bf080d07 有 8 个 LTM 工具。

上一轮判断改变下一轮检索方向

54305c44 从“权限/前缀”转向“首条 yield 后流程没继续”； 84af699b 随后检索 stop_event + yield + pipeline。这是 steer 在任务链中生效的现场证据。