AgentAPI

agent 的实时上下文，完整的消息、工具调用请求均在此索引。

agent 的 id，永远由 UUID.randomUUID 生成。

agent 的模型配置，每个 agent 可以拥有独立的模型配置。

agent 的名称，用于多 agent 场景下的显示区分。

agent 的实时输出流，通常为无需持久化的流式数据块或错误信息。

agent 的实时状态，参见 AgentStatus。

agent 正在调用工具的 callId，也就是 io.github.autotweaker.api.types.agent.AgentMessage.Tool.Call.callId。

实时的工具列表，列表中只有各值的 active 属性会变化，列表本身不会变化。

批准一个工具调用请求。

取消正在进行的上下文压缩进程。

取消正在进行的工具调用。

触发 agent 的上下文压缩，如果上下文压缩正在进行，不会重复触发，上下文压缩在后台进行，此方法不会挂起等待上下文压缩完毕。

在 agent 的上下文中注入 XML 标签，相同 id 的标签会去重。

令 agent 在当前任务完成之后停下，并归档当前上下文。状态将变为 AgentStatus.FREE。

从 agent 的上下文中移除一条标签注入。

向 agent 发送消息，无论 agent 状态如何，消息将始终进入队列。 若 agent 空闲（AgentStatus.FREE），消息将被立即消费，触发 agent 的事件循环。

更新 agent 使用的大模型，下次请求立即生效。

立即停止 agent 的工具调用或 LLM 请求，并归档当前上下文，等待状态变为 AgentStatus.FREE（Stop 完成）。