From f60e5722928476ee7cf77359485e4490024702d0 Mon Sep 17 00:00:00 2001 From: luigisaetta Date: Tue, 23 Sep 2025 15:30:32 +0200 Subject: [PATCH] small changes in README --- ai/gen-ai-agents/custom-rag-agent/LICENSE | 21 +++++++++++++++++++++ ai/gen-ai-agents/custom-rag-agent/README.md | 16 ++++++++++------ 2 files changed, 31 insertions(+), 6 deletions(-) create mode 100644 ai/gen-ai-agents/custom-rag-agent/LICENSE diff --git a/ai/gen-ai-agents/custom-rag-agent/LICENSE b/ai/gen-ai-agents/custom-rag-agent/LICENSE new file mode 100644 index 000000000..fb2e1fcb6 --- /dev/null +++ b/ai/gen-ai-agents/custom-rag-agent/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2025 Luigi Saetta + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/ai/gen-ai-agents/custom-rag-agent/README.md b/ai/gen-ai-agents/custom-rag-agent/README.md index a4dc34c28..9f39acc59 100644 --- a/ai/gen-ai-agents/custom-rag-agent/README.md +++ b/ai/gen-ai-agents/custom-rag-agent/README.md @@ -1,10 +1,11 @@ -![UI](images/ui_image.png) - # Custom RAG agent This repository contains the code for the development of a **custom RAG Agent**, based on **OCI Generative AI**, **Oracle 23AI** Vector Store and **LangGraph** **Author**: L. Saetta -**Last updated**: 09/09/2025 + +**Reviewed**: 23.09.2025 + +![UI](images/ui_image.png) ## Design and implementation * The agent is implemented using **LangGraph** @@ -25,14 +26,17 @@ For example, links to the documentation' chunks are displayed before the final a ### MCP support: (07/2025) I have added an implementation of an **MCP** server that exposes the Semantic Search feature. -Security can be handled in two ways: +* added a [demo LLM with MCP](./ui_mcp_agent.py) showing how to integrate a generic MCP server in a Chatbot using a LLM. + +**Security** can be handled in two ways: * custom: generate the **JWT token** using the library **PyJWT** * **OCI**: generate the JWT token using **OCI IAM** ## Status -It is **WIP**. +It is always and proudly **WIP**. ## References +For more information: * [Integration with OCI APM](https://luigi-saetta.medium.com/enhancing-observability-in-rag-solutions-with-oracle-cloud-6f93b2675f40) ## Advantages of the Agentic approach @@ -45,5 +49,5 @@ For example, to ensure that final responses do not disclose Personally Identifia * use Python 3.11 * use the requirements.txt * create your config_private.py using the template provided -* for MCP server: create a confidential application in OCI IAM +* for MCP server: create a confidential application in **OCI IAM** to handle JWT tokens.