33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
---
|
||
title: "TaskVisibility"
|
||
type: concept
|
||
tags: []
|
||
last_updated: 2026-05-02
|
||
---
|
||
|
||
## Definition
|
||
AI Agent 任务执行过程的可视化透明度——使人类用户能追踪 Agent 的当前状态、已完成步骤和潜在阻塞。
|
||
|
||
## Description
|
||
在长时间运行的 Agentic Workflow 中（如构建全栈应用、深度研究），用户往往无法实时了解：
|
||
- Agent 当前正在执行哪一步
|
||
- 已完成哪些子步骤
|
||
- Agent 在哪里卡住或陷入死循环
|
||
|
||
TaskVisibility 通过外部化 Agent 的内部推理过程来解决这个问题。
|
||
|
||
## Implementation Patterns
|
||
- **状态分区**：使用不同状态标签区分任务阶段（🟡 In Progress / 🟠 Waiting / 🟢 Done）
|
||
- **计划外化**：将 Agent 的内部 Plan 写入任务描述，供人类审阅
|
||
- **实时日志追加**：以评论形式实时追加子步骤完成记录
|
||
- **停滞检测**：心跳脚本自动检测停滞任务并触发告警
|
||
|
||
## Related Concepts
|
||
- [[AgenticWorkflow]]
|
||
- [[ExternalReasoning]]
|
||
- [[ProjectStateManagement]]
|
||
|
||
## Examples
|
||
- [[TodoistTaskManager]]：通过 Todoist 实现 TaskVisibility
|
||
- [[ProjectStateManagement]]：通过事件驱动方案实现任务状态追踪
|