AI Agent二分调试法：快速定位Agent出问题的环节

📘 教程 2026-07-17 约 2 分钟阅读

Agent执行一个10步的任务在第7步出错了。从头排查太慢，从尾排查也慢。二分法最快。

💡 你将学到

Agent执行一个10步的任务在第7步出错了。从头排查太慢，从尾排查也慢。二分法最快。

📜 目录

Agent调试的痛点
二分调试法
实现
总结
相关文章

Agent调试的痛点

Agent执行多步任务时，错误可能在任何环节。最常见的场景：用户说结果不对，你完全不知道是哪里出了问题。

二分调试法

原理和二分查找一样：每次砍掉一半的排查范围。

第1步 -> 第2步 -> 第3步 -> 第4步 -> 第5步 -> 第6步 -> 第7步 -> 第8步
                                        ^
                                    先查这里
如果第4步结果正确 -> 问题在5-8步
如果第4步结果错误 -> 问题在1-4步

实现

给Agent的每一步加上检查点，记录输入输出。

class Checkpoint:
    def __init__(self):
        self.steps = []

    def record(self, step_name, input_data, output_data):
        self.steps.append({
            'step': step_name,
            'input': input_data,
            'output': output_data
        })

    def debug(self, failed_step):
        low, high = 0, len(self.steps) - 1
        while low < high:
            mid = (low + high) // 2
            if self.steps[mid]['output'] is None:
                high = mid
            else:
                low = mid + 1
        return self.steps[low]