跳转到内容
CrewAI 中文文档

Neatlogs 集成

简介

Section titled “简介”

Neatlogs 帮助你看清代理做了什么、为什么这么做，并且方便共享。

它会捕获每一步：思考、工具调用、响应、评估。没有原始日志，只有清晰、结构化的追踪。非常适合调试和协作。

为什么使用 Neatlogs？

Section titled “为什么使用 Neatlogs？”

CrewAI 代理会使用多个工具和推理步骤。当出现问题时，你需要上下文，而不仅仅是错误。

Neatlogs 可以让你：

  • 跟踪完整的决策路径
  • 直接在步骤上添加反馈
  • 使用 AI 助手与追踪记录对话
  • 将运行结果公开分享以获取反馈
  • 把洞察转化为任务

全部集中在一个地方。

轻松管理你的追踪记录

追踪 追踪响应

这是查看 CrewAI 追踪的最佳体验。你可以在任何地方发表评论，并使用 AI 调试。

追踪详情 带有追踪的 AI 聊天机器人 评论抽屉

核心功能

Section titled “核心功能”
  • 追踪查看器：按顺序跟踪思考、工具和决策
  • 行内评论：在任意追踪步骤上标记队友
  • 反馈与评估：将输出标记为正确或错误
  • 错误高亮：自动标记 API/工具失败
  • 任务转换：将评论转换为指派任务
  • 询问追踪（AI）：使用 Neatlogs AI 机器人与追踪对话
  • 公开分享：将追踪链接发布给你的社区

使用 CrewAI 快速设置

Section titled “使用 CrewAI 快速设置”
  1. 注册并获取 API Key

    访问 neatlogs.com，创建项目并复制 API key。

  2. 安装 SDK
    Terminal window
    pip install neatlogs

    （最新版本 0.8.0，Python 3.8+；MIT 许可证）

  3. 初始化 Neatlogs

    在启动 Crew 代理之前，添加：

    import neatlogs
    neatlogs.init("YOUR_PROJECT_API_KEY")

    代理会照常运行。Neatlogs 会自动捕获一切。

工作原理

Section titled “工作原理”

根据 GitHub 信息，Neatlogs：

  • 捕获思考、工具调用、响应、错误和 token 统计
  • 支持 AI 驱动的任务生成与稳健的评估工作流

只需两行代码即可完成。

看它运行

Section titled “看它运行”

🔍 完整演示（4 分钟）

Section titled “🔍 完整演示（4 分钟）”

⚙️ CrewAI 集成（30 秒）

Section titled “⚙️ CrewAI 集成（30 秒）”

链接与支持

Section titled “链接与支持”

TL;DR

Section titled “TL;DR”

只需：

Terminal window
pip install neatlogs


import neatlogs
neatlogs.init("YOUR_API_KEY")


你现在就可以在几秒钟内捕获、理解、共享并处理你的 CrewAI 代理运行。
无需额外设置。完整追踪透明。完整团队协作。