Galileo 集成

概览

本指南演示如何将 Galileo 与 CrewAI 集成，以实现全面追踪和评估工程。读完本指南后，你将能够追踪 CrewAI 代理、监控其性能，并借助 Galileo 强大的可观测性平台评估其行为。

什么是 Galileo？ Galileo 是一个 AI 评估与可观测性平台，提供端到端追踪、评估和监控能力，适用于 AI 应用。它帮助团队采集真实基准、建立稳健的护栏，并通过内置实验跟踪和性能分析执行系统化实验，确保整个 AI 生命周期中的可靠性、透明度和持续改进。

开始使用

本教程基于 CrewAI 快速开始，并演示如何添加 Galileo 的 CrewAIEventListener，这是一个事件处理器。更多信息请参阅 Galileo 的 将 Galileo 添加到 CrewAI 应用 操作指南。

注意 本教程假设你已经完成了 CrewAI 快速开始。 如果你想要一个完整的综合示例，请查看 Galileo 的 CrewAI sdk-example 仓库。

步骤 1：安装依赖

安装应用所需的依赖。 使用你偏好的方式创建虚拟环境，然后在该环境中使用你偏好的工具安装依赖：

uv add galileo

步骤 2：将配置添加到 CrewAI 快速开始 的 .env 文件

# 你的 Galileo API key
GALILEO_API_KEY="your-galileo-api-key"

# 你的 Galileo 项目名称
GALILEO_PROJECT="your-galileo-project-name"

# 你想用于日志记录的 Log stream 名称
GALILEO_LOG_STREAM="your-galileo-log-stream "

步骤 3：添加 Galileo 事件监听器

要启用 Galileo 日志记录，你需要创建一个 CrewAIEventListener 实例。 通过在 main.py 文件顶部添加以下代码来导入 Galileo CrewAI 处理器包：

from galileo.handlers.crewai.handler import CrewAIEventListener

在 run 函数开始时创建事件监听器：

def run():
    # 创建事件监听器
    CrewAIEventListener()
    # 其余现有代码放在这里

创建监听器实例后，它会自动注册到 CrewAI。

步骤 4：运行你的 crew

使用 CrewAI CLI 运行你的 crew：

crewai run

步骤 5：在 Galileo 中查看追踪

当你的 crew 完成后，追踪会刷新并出现在 Galileo 中。

理解 Galileo 集成

Galileo 通过注册一个事件监听器与 CrewAI 集成，该监听器会捕获 Crew 执行事件（例如代理动作、工具调用、模型响应），并将它们转发给 Galileo 进行可观测性和评估。

理解事件监听器

创建一个 CrewAIEventListener() 实例就是启用 Galileo 运行所需的全部操作。实例化后，该监听器会：

• 自动注册到 CrewAI
• 从环境变量读取 Galileo 配置
• 将所有运行数据记录到由 GALILEO_PROJECT 和 GALILEO_LOG_STREAM 指定的 Galileo 项目和日志流

无需额外配置或代码修改。 本次运行的所有数据都会记录到由你的环境配置指定的 Galileo 项目和日志流中 （例如 GALILEO_PROJECT 和 GALILEO_LOG_STREAM）。