跳转到主要内容

文档索引

获取完整文档索引： https://docs.crewai.com.cn/llms.txt

在深入了解之前，请使用此文件来浏览所有可用页面。

​
概述

本指南演示了如何将 Galileo 与 CrewAI 集成，以实现全面的追踪和评估工程。阅读完本指南后，你将能够追踪 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 实例。通过在你的 main.py 文件顶部添加以下代码来导入 Galileo CrewAI 处理器包。 
from galileo.handlers.crewai.handler import CrewAIEventListener
在运行函数的开头，创建事件监听器。 
def run():
    # Create the event listener
    CrewAIEventListener()
    # The rest of your existing code goes here
当你创建监听器实例时，它会自动向 CrewAI 注册。

​
第 4 步：运行你的 Crew

使用 CrewAI CLI 运行你的 Crew。 
crewai run

​
第 5 步：在 Galileo 中查看追踪记录

一旦你的 Crew 运行完成，追踪数据将被提交并显示在 Galileo 中。 Galileo 追踪视图

​
了解 Galileo 集成

Galileo 通过注册事件监听器来集成 CrewAI，该监听器能够捕获 Crew 执行事件（例如：智能体操作、工具调用、模型响应），并将其转发给 Galileo 以实现可观测性和评估。

​
理解事件监听器

创建一个 CrewAIEventListener() 实例即可为 CrewAI 运行启用 Galileo。实例化后，该监听器会：
  • 自动向 CrewAI 注册自身
  • 从环境变量中读取 Galileo 配置
  • 将所有运行数据记录到由 GALILEO_PROJECT 和 GALILEO_LOG_STREAM 指定的 Galileo 项目和日志流中
无需额外的配置或代码更改。本次运行的所有数据都将记录到你环境配置中指定的 Galileo 项目和日志流中（例如：GALILEO_PROJECT 和 GALILEO_LOG_STREAM）。