Decision Guide：Sync vs Async API（同步 vs 异步 API）
知识库位置：
FDE Knowledge Base/03 Engineering/Decision Guides/Sync-vs-Async.md
同步（Sync，同步）调用意味着：
用户或调用系统等待任务完成。
异步（Async，异步）调用意味着：
任务先提交，结果稍后获取。
Sync Example（同步示例）
Section titled “Sync Example（同步示例）”Request（请求）↓Process（处理）↓Response（响应）适合：
- 查询数据
- 快速操作
- 用户需要立即结果
Async Example（异步示例）
Section titled “Async Example（异步示例）”Request（请求）↓Job Created（任务已创建）↓Queue（队列）↓Worker（工作进程）↓Result（结果）适合：
- 大文件处理
- 长时间 AI Task（AI 任务）
- Batch processing（批处理）
- Report generation（报表生成）
- Large document analysis（大文档分析）
Decision Question（决策问题）
Section titled “Decision Question（决策问题）”问：
用户愿意等待多久？
如果任务可能持续几十秒甚至几分钟，通常应该考虑 Async。
Async Requires（异步需要什么）
Section titled “Async Requires（异步需要什么）”- Job ID（任务 ID）
- Job Status（任务状态）
- Retry（重试）
- Queue（队列）
- Result Storage（结果存储）
- Notification / Polling / Callback（通知/轮询/回调）
FDE Principle（FDE 原则）
Section titled “FDE Principle（FDE 原则）”不要让 HTTP Request（HTTP 请求）长时间挂起，只为了避免设计异步流程。