主题
Neatlogs 集成
理解、调试并分享你的 CrewAI 智能体运行记录
概述
Neatlogs 帮助你 看清你的智能体做了什么、为什么，并分享它。
它捕获每一步：思考、工具调用、响应、评估。没有原始日志。只有清晰、结构化的追踪。非常适合调试和协作。
为什么使用 Neatlogs？
CrewAI 智能体会使用多个工具和推理步骤。当出现问题时，你需要上下文——而不仅仅是错误信息。
Neatlogs 让你能够：
- 跟随完整的决策路径
- 直接在步骤上添加反馈
- 使用 AI 助手与追踪对话
- 公开分享运行记录以获取反馈
- 将洞察转化为任务
全部集中在一个地方。
轻松管理你的追踪
查看 CrewAI 追踪的最佳 UX。可在任意位置发表评论。使用 AI 进行调试。
核心能力
- 追踪查看器：按顺序追踪思考、工具和决策
- 内联评论：在任意追踪步骤中标记队友
- 反馈与评估：将输出标记为正确或不正确
- 错误高亮：自动标记 API/工具失败
- 任务转换：将评论转换为已分配的任务
- 询问追踪（AI）：使用 Neatlogs AI 机器人就你的追踪进行对话
- 公开分享：将追踪链接发布到你的社区
使用 CrewAI 快速设置
Sign Up & Get API Key
访问 neatlogs.com，创建项目，复制 API 密钥。
Install SDK
bash
pip install neatlogs（最新版本 0.8.0，Python 3.8+；MIT 许可证）
Initialize Neatlogs
在启动 Crew 智能体之前，添加：
python
import neatlogs
neatlogs.init("YOUR_PROJECT_API_KEY")智能体照常运行。Neatlogs 会自动捕获所有内容。
底层原理
根据 GitHub，Neatlogs：
- 捕获思考、工具调用、响应、错误和 token 统计
- 支持 AI 驱动的任务生成和稳健的评估工作流
只需两行代码即可完成所有这些。
观看实际效果
🔍 完整演示（4 分钟）
⚙️ CrewAI 集成（30 秒）
链接与支持
TL;DR
只需：
bash
pip install neatlogs
import neatlogs
neatlogs.init("YOUR_API_KEY")
You can now capture, understand, share, and act on your CrewAI agent runs in seconds.
No setup overhead. Full trace transparency. Full team collaboration.