[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

FinanceAgent/README.md

@@ -1,4 +1,4 @@
-# Finance Agent Example 
+# Finance Agent Example
 
 ## Table of Contents
 
@@ -10,7 +10,6 @@
 - [Deployment Options](#deployment-options)
 - [Contribution](#contribution)
 
-
 ## Overview
 
 The Finance Agent exemplifies a hierarchical multi-agent system designed to streamline financial document processing and analysis for users. It offers three core functionalities: summarizing lengthy financial documents, answering queries related to these documents, and conducting research to generate investment reports on public companies.
@@ -19,8 +18,8 @@ Navigating and analyzing extensive financial documents can be both challenging a
 
 Users interact with the system through a graphical user interface (UI), where a supervisor agent manages requests by delegating tasks to worker agents or the summarization microservice. The system also supports document uploads via the UI for processing.
 
-
 ## Architecture
+
 ### High-Level Diagram
 
 The architecture of this Finance Agent example is shown in the figure below. The agent is a hierarchical multi-agent system and has 3 main functions:
@@ -33,7 +32,8 @@ The user interacts with the supervisor agent through the graphical UI. The super
 
 ![Finance Agent Architecture](assets/finance_agent_arch.png)
 
-### OPEA Microservices Diagram for Data Handling 
+### OPEA Microservices Diagram for Data Handling
+
 The architectural diagram of the `dataprep` microservice is shown below. We use [docling](https://github.com/docling-project/docling) to extract text from PDFs and URLs into markdown format. Both the full document content and tables are extracted. We then use an LLM to extract metadata from the document, including the company name, year, quarter, document type, and document title. The full document markdown then gets chunked, and LLM is used to summarize each chunk, and the summaries are embedded and saved to a vector database. Each table is also summarized by LLM and the summaries are embedded and saved to the vector database. The chunks and tables are also saved into a KV store. The pipeline is designed as such to improve retrieval accuracy of the `search_knowledge_base` tool used by the Question Answering worker agent.
 
 ![dataprep architecture](assets/fin_agent_dataprep.png)
@@ -52,17 +52,16 @@ The Question Answering worker agent uses `search_knowledge_base` tool to get rel
 
 ![finqa search tool arch](assets/finqa_tool.png)
 
-
 ## Deployment Options
+
 This Finance Agent example can be deployed manually on Docker Compose.
 
-| Hardware        | Deployment Mode      | Guide Link                                                               |
-| :-------------- | :------------------- | :----------------------------------------------------------------------- |
+| Hardware                       | Deployment Mode      | Guide Link                                                               |
+| :----------------------------- | :------------------- | :----------------------------------------------------------------------- |
 | Intel® Gaudi® AI Accelerator | Single Node (Docker) | [Gaudi Docker Compose Guide](./docker_compose/intel/hpu/gaudi/README.md) |
 
 _Note: Building custom microservice images can be done using the resources in [GenAIComps](https://github.com/opea-project/GenAIComps)._
 
-
 ## Contribution
-We welcome contributions to the OPEA project. Please refer to the [contribution guidelines](https://github.com/opea-project/docs/blob/main/community/CONTRIBUTING.md) for more information.
 
+We welcome contributions to the OPEA project. Please refer to the [contribution guidelines](https://github.com/opea-project/docs/blob/main/community/CONTRIBUTING.md) for more information.

FinanceAgent/docker_compose/intel/hpu/gaudi/README.md

@@ -1,4 +1,5 @@
 # Deploy Finance Agent on Intel® Gaudi® AI Accelerator with Docker Compose
+
 This README provides instructions for deploying the Finance Agent application using Docker Compose on systems equipped with Intel® Gaudi® AI Accelerators.
 
 ## Table of Contents
@@ -14,6 +15,7 @@ This README provides instructions for deploying the Finance Agent application us
 This guide focuses on running the pre-configured Finance Agent service using Docker Compose on Intel® Gaudi® AI Accelerators. It leverages containers optimized for Gaudi for the LLM serving component, along with CPU-based containers for other microservices like embedding, retrieval, data preparation and the UI.
 
 ## Prerequisites
+
 - Docker and Docker Compose installed.
 - Intel® Gaudi® AI Accelerator(s) with the necessary drivers and software stack installed on the host system. (Refer to Intel Gaudi Documentation).
 - Git installed (for cloning repository).
@@ -31,8 +33,11 @@ Clone the GenAIExamples repository:
 ```
 
 ## Start Deployment
+
 This uses the default vLLM-based deployment profile (vllm-gaudi-server).
+
 ### Configure Environment
+
 Set required environment variables in your shell:
 
 ```shell
@@ -41,12 +46,12 @@ Set required environment variables in your shell:
    # Path to your model cache
    export HF_CACHE_DIR="./data"
    # Go to https://finnhub.io/ to get your free api key
-   export FINNHUB_API_KEY=<your-finnhub-api-key> 
+   export FINNHUB_API_KEY=<your-finnhub-api-key>
    # Go to https://docs.financialdatasets.ai/ to get your free api key
-   export FINANCIAL_DATASETS_API_KEY=<your-api-key> 
+   export FINANCIAL_DATASETS_API_KEY=<your-api-key>
 
    # Optional: Configure HOST_IP if needed
-   # Replace with your host's external IP address (do not use localhost or 127.0.0.1). 
+   # Replace with your host's external IP address (do not use localhost or 127.0.0.1).
    # export HOST_IP=$(hostname -I | awk '{print $1}')
 
    # Optional: Configure proxy if needed
@@ -60,19 +65,21 @@ Set required environment variables in your shell:
 Note: The compose file might read additional variables from set_env.sh. Ensure all required variables like ports (LLM_SERVICE_PORT, TEI_EMBEDDER_PORT, etc.) are set if not using defaults from the compose file. For instance, edit the set_env.sh to change the LLM model:
 
 ### Start Services
+
 #### Deploy with Docker Compose
+
 Below is the command to launch services
-   - vllm-gaudi-server
-   - tei-embedding-serving
-   - redis-vector-db
-   - redis-kv-store
-   - dataprep-redis-server-finance
-   - finqa-agent-endpoint
-   - research-agent-endpoint
-   - docsum-vllm-gaudi
-   - supervisor-agent-endpoint
-   - agent-ui
 
+- vllm-gaudi-server
+- tei-embedding-serving
+- redis-vector-db
+- redis-kv-store
+- dataprep-redis-server-finance
+- finqa-agent-endpoint
+- research-agent-endpoint
+- docsum-vllm-gaudi
+- supervisor-agent-endpoint
+- agent-ui
 
 ```shell
    docker compose -f compose.yaml up -d
@@ -103,14 +110,16 @@ If deploy on Gaudi, also need to build vllm image.
    docker build --no-cache -f Dockerfile.hpu -t opea/vllm-gaudi:latest --shm-size=128g . --build-arg https_proxy=$https_proxy --build-arg http_proxy=$http_proxy
 ```
 
-
 ## Validate Services
+
 Wait several minutes for models to download and services to initialize (Gaudi initialization can take time). Check container logs (docker compose logs -f <service_name>, especially vllm-gaudi-server).
 
 ```bash
    docker logs --tail 2000 -f vllm-gaudi-server
-``` 
-> Expected output of the `vllm-gaudi-server` service is 
+```
+
+> Expected output of the `vllm-gaudi-server` service is
+
 ```
    INFO:     Started server process [1]
    INFO:     Waiting for application startup.
@@ -121,6 +130,7 @@ Wait several minutes for models to download and services to initialize (Gaudi in
 ```
 
 ### Validate Data Services
+
 Ingest data and retrieval from database
 
 ```bash

FinanceAgent/docker_compose/intel/hpu/gaudi/compose.yaml

@@ -118,7 +118,7 @@ services:
       REDIS_URL_KV: ${REDIS_URL_KV}
       TEI_EMBEDDING_ENDPOINT: ${TEI_EMBEDDING_ENDPOINT}
       LLM_ENDPOINT: ${LLM_ENDPOINT}
-      LLM_MODEL: ${LLM_MODEL_ID}      
+      LLM_MODEL: ${LLM_MODEL_ID}
       HUGGINGFACEHUB_API_TOKEN: ${HF_TOKEN}
       HF_TOKEN: ${HF_TOKEN}
       LOGFLAG: true
@@ -215,5 +215,3 @@ services:
     ports:
       - "5175:8080"
     ipc: host
-
-

FinanceAgent/docker_compose/intel/set_env.sh

@@ -23,7 +23,7 @@ check_var "HF_TOKEN"
 check_var "HOST_IP"
 
 # VLLM configuration
-export VLLM_PORT="${VLLM_PORT:-8086}"  
+export VLLM_PORT="${VLLM_PORT:-8086}"
 export VLLM_VOLUME="${VLLM_VOLUME:-/data2/huggingface}"
 export VLLM_IMAGE="${VLLM_IMAGE:-opea/vllm-gaudi:latest}"
 export LLM_MODEL_ID="${LLM_MODEL_ID:-meta-llama/Llama-3.3-70B-Instruct}"
@@ -70,7 +70,7 @@ export FINANCIAL_DATASETS_API_KEY="${FINANCIAL_DATASETS_API_KEY}"
 
 
 # Toolset and prompt paths
-if check_var "WORKDIR"; then  
+if check_var "WORKDIR"; then
     export TOOLSET_PATH=$WORKDIR/GenAIExamples/FinanceAgent/tools/
     export PROMPT_PATH=$WORKDIR/GenAIExamples/FinanceAgent/prompts/
 
@@ -87,4 +87,3 @@ if check_var "WORKDIR"; then
         fi
     done
 fi
-

FinanceAgent/tests/test_compose_on_gaudi.sh

@@ -17,7 +17,7 @@ export HTTPS_PROXY="${https_proxy}"
 
 # VLLM configuration
 MODEL=meta-llama/Llama-3.3-70B-Instruct
-export VLLM_PORT="${VLLM_PORT:-8086}" 
+export VLLM_PORT="${VLLM_PORT:-8086}"
 
 # export HF_CACHE_DIR="${HF_CACHE_DIR:-"./data"}"
 export HF_CACHE_DIR=${model_cache:-"./data2/huggingface"}