Function main

tutorials/01_agentic_loop_basics.py:232–271

()

# ============================================================

def main():
    print("=" * 60)
    print("Tutorial 01: Agentic Loop 基础演示")
    print("=" * 60)
    print()
    print("场景：用户问 '2+2 等于几？'")
    print("AI 不直接回答，而是先调用 add 工具，再根据结果回答。")
    print()

    ai = FakeAI()
    session = []  # 空的对话历史

    # 执行一个对话轮次
    session = run_turn(ai, session, "2+2 等于几？")

    # 打印最终的完整对话历史
    print("\n" + "=" * 60)
    print("完整对话历史：")
    print("=" * 60)
    for i, msg in enumerate(session):
        print(f"  [{i}] {msg}")

    # 解说
    print("\n" + "=" * 60)
    print("关键理解要点：")
    print("=" * 60)
    print("""
    1. Agentic Loop 的核心是一个 while True 循环
    2. 每轮循环调用一次 AI，AI 可能回复文字，也可能要求使用工具
    3. 如果 AI 要用工具 → 执行工具 → 把结果加入对话 → 继续循环
    4. 如果 AI 回复文字 → 循环结束
    5. 对话历史（session）是 AI 的"记忆"，每次调用都传入全部历史

    对应 Claude Code 源码:
    - conversation.rs:170  →  run_turn() 函数入口
    - conversation.rs:183  →  while True 循环开始
    - conversation.rs:196  →  调用 API (api_client.stream)
    - conversation.rs:214  →  判断是否有 tool_use（break 条件）
    - conversation.rs:218  →  遍历 pending_tool_uses 并执行
    """)


if __name__ == "__main__":