Datafy / agents.py
Janarthanan-Gnanamurthy's picture
Update agents.py
f664023 verified
import os
import re
import json
import logging
import httpx
import pandas as pd
import numpy as np
from typing import Dict, List, TypedDict, Annotated, Literal
from fastapi import HTTPException
from langgraph.graph import StateGraph, START, END
from langgraph.prebuilt import ToolNode
from langchain_core.messages import BaseMessage, HumanMessage, AIMessage
from langchain_core.tools import tool
import matplotlib.pyplot as plt
import seaborn as sns
from scipy import stats
import warnings
import io
import base64
import tempfile
from dotenv import load_dotenv
# Load environment variables from .env file
load_dotenv()
# Configure logging
logging.basicConfig(
level=logging.INFO,
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)
logger = logging.getLogger(__name__)
# Define the agent state
class AgentState(TypedDict):
messages: Annotated[List[BaseMessage], "The conversation messages"]
prompt: str
dataframe: pd.DataFrame
columns: List[str]
intent: Dict
chart_config: Dict
code: str
result: Dict
error: str
next_action: str
plot_path: str
async def generate(prompt, temperature=0.2, model="gemma3:12b-it-qat"):
"""Generate response using your deployed Ollama API."""
url = "https://janarthanan-gnanamurthy--ollama-server2-ollamaserver-serve.modal.run/v1/chat/completions"
headers = {
"Content-Type": "application/json",
}
payload = {
"model": model,
"messages": [
{
"role": "user",
"content": prompt
}
],
"temperature": temperature,
"max_tokens": 8192,
"stream": False
}
try:
async with httpx.AsyncClient(timeout=120.0) as client:
response = await client.post(
url,
json=payload,
headers=headers
)
response.raise_for_status()
result = response.json()
# Extract text from Ollama/OpenAI compatible response
if "choices" in result and len(result["choices"]) > 0:
choice = result["choices"][0]
if "message" in choice and "content" in choice["message"]:
return choice["message"]["content"]
return ""
except httpx.HTTPStatusError as e:
logger.error(f"HTTP error from Ollama API: {e.response.status_code} - {e.response.text}")
raise HTTPException(status_code=e.response.status_code, detail=f"Ollama API error: {e.response.text}")
except Exception as e:
logger.error(f"Error generating response with Ollama: {str(e)}")
raise HTTPException(status_code=500, detail=f"Error generating response with Ollama: {str(e)}")
def create_chart(df: pd.DataFrame, chart_config: Dict) -> str:
"""Create a matplotlib chart and return the base64 encoded image."""
try:
plt.style.use('seaborn-v0_8')
fig, ax = plt.subplots(figsize=(12, 8))
chart_type = chart_config.get("chart_type", "bar")
x_axis = chart_config.get("x_axis")
y_axis = chart_config.get("y_axis")
title = chart_config.get("title", "Chart")
aggregation = chart_config.get("aggregation", "none")
# Handle data aggregation if needed
plot_df = df.copy()
if aggregation != "none" and x_axis and y_axis:
if aggregation == "sum":
plot_df = df.groupby(x_axis)[y_axis].sum().reset_index()
elif aggregation == "mean":
plot_df = df.groupby(x_axis)[y_axis].mean().reset_index()
elif aggregation == "count":
plot_df = df.groupby(x_axis)[y_axis].count().reset_index()
# Create the chart based on type
if chart_type == "bar":
if aggregation != "none":
ax.bar(plot_df[x_axis], plot_df[y_axis])
else:
sns.barplot(data=plot_df, x=x_axis, y=y_axis, ax=ax)
elif chart_type == "line":
if aggregation != "none":
ax.plot(plot_df[x_axis], plot_df[y_axis], marker='o')
else:
sns.lineplot(data=plot_df, x=x_axis, y=y_axis, ax=ax)
elif chart_type == "scatter":
sns.scatterplot(data=plot_df, x=x_axis, y=y_axis, ax=ax)
elif chart_type == "histogram":
if x_axis in df.columns:
ax.hist(df[x_axis].dropna(), bins=30, alpha=0.7)
elif chart_type == "boxplot":
if y_axis and x_axis:
sns.boxplot(data=plot_df, x=x_axis, y=y_axis, ax=ax)
else:
ax.boxplot(df.select_dtypes(include=[np.number]).dropna())
elif chart_type == "pie":
if x_axis:
value_counts = df[x_axis].value_counts()
ax.pie(value_counts.values, labels=value_counts.index, autopct='%1.1f%%')
elif chart_type == "area":
if x_axis and y_axis:
ax.fill_between(plot_df[x_axis], plot_df[y_axis], alpha=0.7)
# Customize the chart
ax.set_title(title, fontsize=16, fontweight='bold')
if x_axis and chart_type != "pie":
ax.set_xlabel(x_axis.replace('_', '').title(), fontsize=12)
if y_axis and chart_type not in ["pie", "histogram"]:
ax.set_ylabel(y_axis.replace('_', ' ').title(), fontsize=12)
# Rotate x-axis labels if they're long
if chart_type not in ["pie", "histogram"]:
plt.xticks(rotation=45, ha='right')
plt.tight_layout()
# Save to base64
buffer = io.BytesIO()
plt.savefig(buffer, format='png', dpi=300, bbox_inches='tight')
buffer.seek(0)
image_base64 = base64.b64encode(buffer.read()).decode()
plt.close(fig)
return image_base64
except Exception as e:
logger.error(f"Error creating chart: {str(e)}")
plt.close('all') # Clean up any open figures
return None
# Agent nodes
async def analyze_intent_node(state: AgentState) -> AgentState:
"""Analyze the user's prompt to determine intent."""
prompt = state["prompt"]
columns = state["columns"]
response_format = {
"intent": "statistical",
"reason": "Prompt requests statistical analysis",
"visualization_type": None,
"transformation_type": None,
"statistical_type": "correlation"
}
input_text = f"""Analyze the following prompt and determine if it's requesting data transformation, visualization, or statistical analysis:
Prompt: {prompt}
Available columns: {', '.join(columns)}
Provide a JSON response with:
1. intent: Either 'visualization', 'transformation', or 'statistical'
2. reason: Brief explanation of why this classification was chosen
3. visualization_type: If intent is 'visualization', specify the chart type ('bar', 'line', 'pie', 'scatter', 'area', 'histogram', 'boxplot')
4. transformation_type: If intent is 'transformation', specify the operation type ('aggregate', 'filter', 'join', 'compute', 'sort', 'group')
5. statistical_type: If intent is 'statistical', specify the test type ('correlation', 'ttest', 'regression', 'descriptive'),
Example response format:
{json.dumps(response_format)}"""
try:
json_text = await generate(input_text, temperature=0.4)
# Try to extract JSON from markdown code blocks if present
json_match = re.search(r"```(?:json)?\n(.*?)\n```", json_text, re.DOTALL)
if json_match:
json_text = json_match.group(1)
json_text = json_text.strip()
try:
intent = json.loads(json_text)
except json.JSONDecodeError:
# If direct parsing fails, try to extract just the JSON object
json_obj_match = re.search(r"(\{.*\})", json_text, re.DOTALL)
if json_obj_match:
intent = json.loads(json_obj_match.group(1))
else:
# Fallback classification based on keywords
prompt_lower = prompt.lower()
if any(word in prompt_lower for word in ['chart', 'plot', 'graph', 'visualiz', 'show']):
intent = {"intent": "visualization", "reason": "Keywords suggest visualization"}
elif any(word in prompt_lower for word in ['filter', 'transform', 'add', 'modify', 'create column']):
intent = {"intent": "transformation", "reason": "Keywords suggest transformation"}
else:
intent = {"intent": "statistical", "reason": "Default to statistical analysis"}
state["intent"] = intent
state["next_action"] = intent["intent"]
logger.info(f"Intent analysis result: {intent}")
except Exception as e:
state["error"] = f"Error analyzing prompt intent: {str(e)}"
state["next_action"] = "error"
logger.error(f"Error in analyze_intent_node: {str(e)}")
return state
async def generate_visualization_node(state: AgentState) -> AgentState:
"""Generate visualization configuration and create the chart."""
prompt = state["prompt"]
columns = state["columns"]
df = state["dataframe"]
response_format = {
"chart_type": "bar",
"x_axis": "date",
"y_axis": "sales",
"aggregation": "sum",
"title": "Total Sales by Date"
}
input_text = f"""Based on the following prompt, determine the appropriate chart configuration:
Prompt: {prompt}
Available columns: {', '.join(columns)}
Generate a JSON configuration with:
1. chart_type: 'bar', 'line', 'pie', 'scatter', 'area', 'histogram', 'boxplot'
2. x_axis: column name for x-axis (choose from available columns)
3. y_axis: column name for y-axis (can be None for histograms, choose from available columns)
4. aggregation: 'sum', 'mean', 'count', 'none'
5. title: descriptive chart title
Example response format:
{json.dumps(response_format)}
Provide only the JSON configuration, no explanations."""
try:
json_text = await generate(input_text, temperature=0.5)
json_match = re.search(r"```(?:json)?\n(.*?)\n```", json_text, re.DOTALL)
if json_match:
json_text = json_match.group(1)
json_text = json_text.strip()
try:
chart_config = json.loads(json_text)
except json.JSONDecodeError:
json_obj_match = re.search(r"(\{.*\})", json_text, re.DOTALL)
if json_obj_match:
chart_config = json.loads(json_obj_match.group(1))
else:
# Fallback configuration
numeric_cols = df.select_dtypes(include=[np.number]).columns.tolist()
categorical_cols = df.select_dtypes(include=['object']).columns.tolist()
chart_config = {
"chart_type": "bar",
"x_axis": categorical_cols[0] if categorical_cols else columns[0],
"y_axis": numeric_cols[0] if numeric_cols else columns[1] if len(columns) > 1 else None,
"aggregation": "mean" if numeric_cols else "count",
"title": "Data Visualization"
}
# Validate column names exist
if chart_config.get("x_axis") not in columns:
chart_config["x_axis"] = columns[0]
if chart_config.get("y_axis") and chart_config["y_axis"] not in columns:
numeric_cols = df.select_dtypes(include=[np.number]).columns.tolist()
chart_config["y_axis"] = numeric_cols[0] if numeric_cols else None
state["chart_config"] = chart_config
# Create the chart immediately
image_base64 = create_chart(df, chart_config)
if image_base64:
state["result"] = {
"type": "visualization",
"chart_type": chart_config["chart_type"],
"config": chart_config,
"image": image_base64,
"message": "Visualization created successfully"
}
state["next_action"] = "complete"
else:
state["error"] = "Failed to create visualization"
state["next_action"] = "error"
logger.info(f"Generated chart config: {chart_config}")
except Exception as e:
state["error"] = f"Error generating chart configuration: {str(e)}"
state["next_action"] = "error"
logger.error(f"Error in generate_visualization_node: {str(e)}")
return state
async def generate_transformation_node(state: AgentState) -> AgentState:
"""Generate pandas transformation code."""
prompt = state["prompt"]
columns = state["columns"]
input_text = f"""Write Python code to perform the following pandas DataFrame transformation:
{prompt}
Available columns: {', '.join(columns)}
Pandas Knowledge Base:
1. DataFrame Operations:
- select columns: df[['col1', 'col2']]
- filter rows: df[df['column'] > value]
- group data: df.groupby('column')
- sort data: df.sort_values('column')
- add/modify columns: df['new_col'] = df['col1'] * 2
- drop columns: df.drop(['col1'], axis=1)
- remove duplicates: df.drop_duplicates()
- merge dataframes: pd.merge(df1, df2)
2. Common Functions:
- df.apply(): Apply function to columns/rows
- df.fillna(): Fill missing values
- df.dropna(): Drop missing values
- df.replace(): Replace values
- pd.to_datetime(): Convert to datetime
- df.astype(): Convert data types
- df.round(): Round numbers
- df.sum(), df.mean(), df.count(): Aggregations
3. String Operations:
- df['col'].str.contains(): String contains
- df['col'].str.split(): Split strings
- df['col'].str.replace(): Replace in strings
- df['col'].str.upper(): Convert to uppercase
4. Window Operations:
- df.rolling(): Rolling window operations
- df.shift(): Shift values
- df.expanding(): Expanding window
Requirements:
1. Use pandas DataFrame operations
2. Handle missing values appropriately
3. Store result in 'transformed_df'
4. DO NOT define functions
5. Return a pandas DataFrame
6. Use proper type conversions if needed
Available variables:
- df: pandas DataFrame
- pd: pandas module
- np: numpy module
Example format:
```python
transformed_df = df.copy()
transformed_df['new_column'] = df['column1'] * df['column2']
transformed_df = transformed_df.fillna(0) # Handle nulls
```
Provide only the code, no explanations. DO NOT DEFINE functions, directly perform the operations on the df."""
try:
code = await generate(input_text, temperature=0.4)
code_match = re.search(r"```python\n(.*?)\n```", code, re.DOTALL)
code = code_match.group(1) if code_match else code
state["code"] = code
state["next_action"] = "execute"
logger.info(f"Generated transformation code: {code}")
except Exception as e:
state["error"] = f"Error generating transformation code: {str(e)}"
state["next_action"] = "error"
logger.error(f"Error in generate_transformation_node: {str(e)}")
return state
async def generate_statistical_node(state: AgentState) -> AgentState:
"""Generate robust pandas/numpy code for statistical analysis with fallbacks."""
prompt = state.get("prompt", "")
print(prompt+" - Prompt received in generate_statistical_node")
columns = state.get("columns", [])
# Use predefined templates based on prompt keywords
operations = []
if any(x in prompt.lower() for x in ["describe", "summary"]):
operations.append("describe")
if any(x in prompt.lower() for x in ["correlation", "corr"]):
operations.append("correlation")
if any(x in prompt.lower() for x in ["ttest", "hypothesis"]):
operations.append("ttest")
if not operations:
operations = ["describe"] # default
code_blocks = []
# Build code blocks robustly
if "describe" in operations:
code_blocks.append(
"# Descriptive statistics\n"
"desc = df.describe(include='all')\n"
)
if "correlation" in operations:
code_blocks.append(
"# Correlation for numeric columns\n"
"num_cols = df.select_dtypes(include=[np.number]).columns.tolist()\n"
"corr = df[num_cols].corr() if len(num_cols) > 1 else pd.DataFrame()\n"
)
if "ttest" in operations and 'category' in columns:
# safe t-test only if category and value exist
code_blocks.append(
"# Independent T-test between two groups in 'category' on 'value' column\n"
"groups = df['category'].dropna().unique().tolist()[:2]\n"
"if len(groups) == 2:\n"
" g1 = df[df['category'] == groups[0]]['value'].dropna()\n"
" g2 = df[df['category'] == groups[1]]['value'].dropna()\n"
" t_stat, p_val = stats.ttest_ind(g1, g2, nan_policy='omit')\n"
"else:\n"
" t_stat, p_val = None, None\n"
)
# Assemble result dict
code_blocks.append(
"# Assemble results\n"
"results = {}\n"
"if 'desc' in locals(): results['descriptive'] = desc\n"
"if 'corr' in locals(): results['correlation'] = corr\n"
"if 't_stat' in locals(): results['ttest'] = {'t_statistic': t_stat, 'p_value': p_val}\n"
"# Final assignment\n"
"stat_result = results\n"
)
state['code'] = '\n'.join(code_blocks)
state['next_action'] = 'execute'
logger.info(f"Generated statistical code with operations {operations}")
return state
async def execute_code_node(state: AgentState) -> AgentState:
"""Execute the generated code safely."""
code = state["code"]
df = state["dataframe"]
if not code:
state["error"] = "No code to execute"
state["next_action"] = "error"
return state
try:
# Create safe execution environment
safe_globals = {
'df': df,
'pd': pd,
'np': np,
'stats': stats,
'plt': plt,
'sns': sns
}
# Execute the code
exec(code, safe_globals)
# Extract results based on intent
intent = state["intent"]["intent"]
if intent == "transformation":
if 'transformed_df' in safe_globals:
result_df = safe_globals['transformed_df']
state["result"] = {
"type": "transformation",
"shape": result_df.shape,
"columns": result_df.columns.tolist(),
"preview": result_df.head(10).to_html(classes='table table-striped'),
"dataframe": result_df,
"message": f"Data transformed successfully. New shape: {result_df.shape}"
}
else:
state["error"] = "No 'transformed_df' found in execution result"
elif intent == "statistical":
exec(code, safe_globals)
stat_result = safe_globals.get('stat_result')
if stat_result is None:
raise ValueError("'stat_result' not found after execution")
if not isinstance(stat_result, dict):
stat_result = {'result': stat_result}
formatted = format_statistical_result(stat_result)
state['result'] = {
'type': 'statistical',
'data': formatted,
'message': 'Statistical analysis completed successfully'
}
state["next_action"] = "complete"
logger.info("Code executed successfully")
except Exception as e:
state["error"] = f"Error executing code: {str(e)}"
state["next_action"] = "error"
logger.error(f"Error in execute_code_node: {str(e)}")
return state
def format_statistical_result(stat_result) -> str:
"""Format statistical results for display in Gradio."""
try:
if isinstance(stat_result, pd.DataFrame):
return stat_result.to_html(classes='table table-striped')
elif isinstance(stat_result, dict):
html_parts = []
for key, value in stat_result.items():
html_parts.append(f"<h4>{key.replace('_', ' ').title()}</h4>")
if isinstance(value, pd.DataFrame):
html_parts.append(value.to_html(classes='table table-striped'))
elif isinstance(value, (int, float)):
html_parts.append(f"<p><strong>{value:.6f}</strong></p>")
else:
html_parts.append(f"<p>{str(value)}</p>")
return ''.join(html_parts)
else:
return f"<p><strong>Result:</strong> {str(stat_result)}</p>"
except Exception as e:
return f"<p><strong>Error formatting result:</strong> {str(e)}</p>"
async def error_handler_node(state: AgentState) -> AgentState:
"""Handle errors and provide feedback."""
error = state.get("error", "Unknown error occurred")
logger.error(f"Error in agent workflow: {error}")
state["result"] = {
"type": "error",
"message": error,
"suggestions": [
"Check if the column names are correct",
"Verify that the data types are appropriate",
"Ensure the prompt is clear and specific"
]
}
state["next_action"] = "complete"
return state
def route_based_on_intent(state: AgentState) -> Literal["visualization", "transformation", "statistical", "error"]:
"""Route to appropriate node based on intent analysis."""
if state.get("error"):
return "error"
intent = state.get("intent", {}).get("intent", "error")
return intent
def route_to_execution(state: AgentState) -> Literal["execute", "error", "complete"]:
"""Route to execution or error handling."""
if state.get("error"):
return "error"
next_action = state.get("next_action", "error")
if next_action == "execute":
return "execute"
elif next_action == "complete":
return "complete"
else:
return "error"
# Build the LangGraph workflow
def create_data_analysis_agent():
"""Create the data analysis agent using LangGraph."""
# Create the state graph
workflow = StateGraph(AgentState)
# Add nodes
workflow.add_node("analyze_intent", analyze_intent_node)
workflow.add_node("visualization", generate_visualization_node)
workflow.add_node("transformation", generate_transformation_node)
workflow.add_node("statistical", generate_statistical_node)
workflow.add_node("execute", execute_code_node)
workflow.add_node("error_handler", error_handler_node)
# Add edges
workflow.add_edge(START, "analyze_intent")
# Conditional edges based on intent
workflow.add_conditional_edges(
"analyze_intent",
route_based_on_intent,
{
"visualization": "visualization",
"transformation": "transformation",
"statistical": "statistical",
"error": "error_handler"
}
)
# Route from generation nodes to execution
workflow.add_conditional_edges(
"visualization",
route_to_execution,
{
"execute": "execute",
"complete": END,
"error": "error_handler"
}
)
workflow.add_conditional_edges(
"transformation",
route_to_execution,
{
"execute": "execute",
"complete": END,
"error": "error_handler"
}
)
workflow.add_conditional_edges(
"statistical",
route_to_execution,
{
"execute": "execute",
"complete": END,
"error": "error_handler"
}
)
# Final edges
workflow.add_edge("execute", END)
workflow.add_edge("error_handler", END)
# Compile the graph
app = workflow.compile()
return app
# Main execution function
async def analyze_data_with_agent(prompt: str, dataframe: pd.DataFrame) -> Dict:
"""
Analyze data using the LangGraph agent.
Args:
prompt: Natural language prompt describing the analysis
dataframe: Pandas DataFrame to analyze
Returns:
Dictionary containing the analysis results
"""
# Create the agent
agent = create_data_analysis_agent()
# Initialize state
initial_state = {
"messages": [HumanMessage(content=prompt)],
"prompt": prompt,
"dataframe": dataframe,
"columns": dataframe.columns.tolist(),
"intent": {},
"chart_config": {},
"code": "",
"result": {},
"error": "",
"next_action": "",
"plot_path": ""
}
# Run the agent
try:
final_state = await agent.ainvoke(initial_state)
return final_state["result"]
except Exception as e:
logger.error(f"Error running agent: {str(e)}")
return {
"type": "error",
"message": f"Agent execution failed: {str(e)}"
}
# Test function
async def test_agent():
"""Test the data analysis agent."""
# Create sample data
data = {
'date': pd.date_range('2024-01-01', periods=100),
'sales': np.random.normal(1000, 200, 100),
'category': np.random.choice(['A', 'B', 'C'], 100),
'region': np.random.choice(['North', 'South', 'East', 'West'], 100)
}
df = pd.DataFrame(data)
# Test different types of prompts
test_prompts = [
"Create a bar chart showing average sales by category",
"Calculate correlation between date and sales",
"Filter the data to show only category A and add a profit column that is 20% of sales"
]
for prompt in test_prompts:
print(f"\n--- Testing: {prompt} ---")
result = await analyze_data_with_agent(prompt, df)
print(f"Result: {result}")
if __name__ == "__main__":
import asyncio
asyncio.run(test_agent())