fix: upgrade to langfuse sdk v3

unit2/langgraph/mail_sorting.ipynb

@@ -1,8 +1,8 @@
 {
  "cells": [
   {
-   "metadata": {},
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "# Alfred the Mail Sorting Butler: A LangGraph Example\n",
     "\n",
@@ -24,18 +24,18 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "# Install the required packages\n",
     "%pip install -q langgraph langchain_openai langchain_huggingface"
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "## Setting Up Our Environment\n",
     "\n",
@@ -43,10 +43,10 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "import os\n",
     "from typing import TypedDict, List, Dict, Any, Optional\n",
@@ -62,8 +62,8 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "## Step 1: Define Our State\n",
     "\n",
@@ -77,10 +77,10 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "class EmailState(TypedDict):\n",
     "    email: Dict[str, Any]\n",
@@ -92,15 +92,17 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
-   "source": "## Step 2: Define Our Nodes"
+   "metadata": {},
+   "source": [
+    "## Step 2: Define Our Nodes"
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "def read_email(state: EmailState):\n",
     "    email = state[\"email\"]\n",
@@ -212,15 +214,17 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
-   "source": "## Step 3: Define Our Routing Logic"
+   "metadata": {},
+   "source": [
+    "## Step 3: Define Our Routing Logic"
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "# Add edges\n",
     "email_graph.add_edge(START, \"read_email\")  # After starting we go to the \"read_email\" node\n",
@@ -244,25 +248,27 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
-   "source": "## Step 4: Create the StateGraph and Define Edges"
+   "metadata": {},
+   "source": [
+    "## Step 4: Create the StateGraph and Define Edges"
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "# Compile the graph\n",
     "compiled_graph = email_graph.compile()"
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "from IPython.display import Image, display\n",
     "\n",
@@ -270,10 +276,10 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     " # Example emails for testing\n",
     "legitimate_email = {\n",
@@ -311,8 +317,8 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "## Step 5: Inspecting Our Mail Sorting Agent with Langfuse 📡\n",
     "\n",
@@ -324,22 +330,26 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
-   "source": "%pip install -q langfuse"
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%pip install -q langfuse"
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
-   "source": "Next, we set the Langfuse API keys and host address as environment variables. You can get your Langfuse credentials by signing up for [Langfuse Cloud](https://cloud.langfuse.com) or [self-hosting Langfuse](https://langfuse.com/self-hosting)."
+   "metadata": {},
+   "source": [
+    "Next, we set the Langfuse API keys and host address as environment variables. You can get your Langfuse credentials by signing up for [Langfuse Cloud](https://cloud.langfuse.com) or [self-hosting Langfuse](https://langfuse.com/self-hosting)."
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "import os\n",
     "\n",
@@ -351,32 +361,36 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
-   "source": "Now, we configure the [Langfuse `callback_handler`](https://langfuse.com/docs/integrations/langchain/tracing#add-langfuse-to-your-langchain-application)."
+   "metadata": {},
+   "source": [
+    "Now, we configure the [Langfuse `callback_handler`](https://langfuse.com/docs/integrations/langchain/tracing#add-langfuse-to-your-langchain-application)."
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
-    "from langfuse.callback import CallbackHandler\n",
+    "from langfuse.langchain import CallbackHandler\n",
     "\n",
     "# Initialize Langfuse CallbackHandler for LangGraph/Langchain (tracing)\n",
     "langfuse_handler = CallbackHandler()"
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
-   "source": "We then add `config={\"callbacks\": [langfuse_handler]}` to the invocation of the agents and run them again."
+   "metadata": {},
+   "source": [
+    "We then add `config={\"callbacks\": [langfuse_handler]}` to the invocation of the agents and run them again."
+   ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
    "execution_count": null,
+   "metadata": {},
+   "outputs": [],
    "source": [
     "# Process legitimate email\n",
     "print(\"\\nProcessing legitimate email...\")\n",
@@ -404,8 +418,8 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "markdown",
+   "metadata": {},
    "source": [
     "Alfred is now connected 🔌! The runs from LangGraph are being logged in Langfuse, giving him full visibility into the agent's behavior. With this setup, he's ready to revisit previous runs and refine his Mail Sorting Agent even further.\n",
     "\n",