Galileo

面向 CrewAI 的 Galileo 集成，支持追踪与评估

概述

本指南演示如何将 Galileo 与 CrewAI 集成， 以实现全面的追踪与评估工程（Evaluation Engineering）。 完成本指南后，你将能够追踪 CrewAI 智能体， 监控其性能，并使用 Galileo 强大的可观测性平台 评估其行为。

什么是 Galileo？ Galileo 是一个 AI 评估与可观测性 平台，为 AI 应用提供端到端追踪、评估 和监控。它使团队能够捕获真实基准（ground truth）、 创建稳健的护栏，并借助内置的实验跟踪与性能分析 运行系统化实验——从而确保 AI 全生命周期中的可靠性、 透明度与持续改进。

入门

本教程遵循 CrewAI 快速入门，并展示如何添加 Galileo 的 CrewAIEventListener 事件处理器。 更多信息，请参阅 Galileo 的 将 Galileo 添加到 CrewAI 应用 操作指南。

注意 本教程假定你已完成 CrewAI 快速入门。 如果你想要一个完整的综合示例，请参阅 Galileo 的 CrewAI sdk-example 仓库。

第 1 步：安装依赖

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

uv add galileo

第 2 步：添加到 CrewAI 快速入门 中的 .env 文件

# Your Galileo API key
GALILEO_API_KEY="your-galileo-api-key"

# Your Galileo project name
GALILEO_PROJECT="your-galileo-project-name"

# The name of the Log stream you want to use for logging
GALILEO_LOG_STREAM="your-galileo-log-stream "

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

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

from galileo.handlers.crewai.handler import CrewAIEventListener

在你的 run 函数开头，创建事件监听器：

def run():
    # Create the event listener
    CrewAIEventListener()
    # The rest of your existing code goes here

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

第 4 步：运行你的团队

使用 CrewAI CLI 运行你的团队：

crewai run

第 5 步：在 Galileo 中查看追踪

你的团队运行完成后，追踪会被刷新并显示在 Galileo 中。

了解 Galileo 集成

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

了解事件监听器

创建一个 CrewAIEventListener() 实例，就足以 为 CrewAI 运行启用 Galileo。实例化后，监听器会：

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

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