---
title: "ExternalReasoning"
type: concept
tags: []
last_updated: 2026-05-02
---

## Definition
将 AI Agent 内部推理过程外化到外部系统（如 Todoist、Notion、数据库）的方法——使 Agent 的思考过程对人类可见，提高 Agent 行为的可观测性和可审计性。

## Description
传统 AI 系统是"黑箱"——用户只能看到输入和输出，看不到中间推理。ExternalReasoning 反其道而行：
- 将 Agent 的"思考"（Plan）写入外部系统的任务描述字段
- 将中间步骤的推理结果追加为评论或日志
- 保留完整的推理轨迹，供后续回溯和分析

核心价值：
- **可观测性**：用户实时了解 Agent 在想什么、做什么
- **可审计性**：记录完整的决策链，便于事后复盘
- **协同交接**：不同 Agent 或人类可以通过外部系统理解当前状态

## Implementation Patterns
- 任务描述字段存储 Agent 的 Plan/Strategy
- 任务评论追加推理过程和步骤完成记录
- 外部系统（如 Todoist）作为推理过程的"外脑"

## Related Concepts
- [[TaskVisibility]]
- [[AgenticWorkflow]]

## Examples
- [[TodoistTaskManager]]：将 Agent Plan 外化到 Todoist 任务描述，将子步骤日志追加为评论