<div class="alert">
We highly encourage our users to carefully review this agentic framework, including its architecture and prompts, revise the framework as needed, and thoroughly test its performance with users' preferred LLMs before implementation.
</div> 

# Technical Requirements
This section details the environment and configurations required to run this solution.

### Instance Specifications
This solution is only compatible on instances with  **Dataiku DSS v14.5+**
  
# Code Environment
Project python recipes uses the code env **solution_next-best-action** on **Python 3.10**.


Required packages for this code env are: 
>dash
flask
pulp
dash_bootstrap_components

# Plug-ins
The following plugins must be installed on the instance. Refer to the linked documentation for installation and configuration:
- [Time Series Preparation](https://doc.dataiku.com/dss/latest/time-series/time-series-preparation/index.html)  **V2.1.2** 
- [Agent Hub](https://doc.dataiku.com/dss/latest/agents/agent-hub.html) **v1.2.4+**


# Required LLM Connections

Connections must be configured in Dataiku before using the solution.

| Agent Role | Recommended Model | Rationale |
| :--- | :--- | :--- |
| **Main Agent** | OpenAI gpt-4o-mini | Complex orchestration requiring large context windows and multi-step reasoning. |
| **Light Agent** | OpenAI gpt-4o-mini | Summarization, explainability generation, and structured narrative production. |
| **Embedding Model** | OpenAI text-embedding-3-small | Semantic search, retrieval, semantic model indexing, and knowledge bank embeddings. |

**Tested LLMs:**
Performance is not guaranteed on models outside of this list:
 - Completion: gpt-4o, 4.1, 5, 5mini (OpenAI), claude 4.6, 4.5 (Anthropic)
 - Embedding: text-embedding-3-small (OpenAI)
 
# Data Storage Requirements
- Tested connections : **PostgreSQL, Snowflake**
- [final_dataset_sql](dataset:final_dataset_sql) requires an **SQL** connection

