This project shows how to create a Chatbot that extends ChatGPT with your own data, using the RAG pattern with vector search. It shows three approaches to the problem: interacting directly with OpenAI APIs, using LangChain, and using Semantic Kernel.
Update: If you want to run this project with a more recent version of OpenAI's API, see the changes in this pull request. Thanks to @xcvil for contributing these changes! |
---|
- You need to have an Azure subscription. You can get a free subscription to try it out.
- Create a "Cognitive Search" resource on Azure.
- Create an "OpenAI" resource on Azure. Create two deployments within this resource:
- A deployment for the "text-embedding-ada-002" model.
- A deployment for the "gpt-35-turbo" model.
- Add a ".env" file to the project with the following variables set (you can use the ".env-example" file as a starting point):
- AZURE_OPENAI_API_BASE - Go to https://oai.azure.com/, "Chat Playground", "View code", and find the API base in the code.
- AZURE_OPENAI_API_KEY - In the same window, copy the "Key" at the bottom.
- AZURE_OPENAI_EMBEDDING_DEPLOYMENT - Click on "Deployments" and find the name of the deployment for the "text-embedding-ada-002" model.
- AZURE_OPENAI_CHATGPT_DEPLOYMENT - In the same window, find the name of the deployment for the "gpt-35-turbo" model.
- AZURE_SEARCH_ENDPOINT - Go to https://portal.azure.com/, find your "Cognitive Search" resource, and find the "Url".
- AZURE_SEARCH_KEY - On the same resource page, click on "Settings", then "Keys", then copy the "Primary admin key".
- AZURE_SEARCH_SERVICE_NAME - This is the name of the "Cognitive Search" resource in the portal.
Install the packages specified in the environment.yml file:
conda env create -f environment.yml
conda activate rag
You can run the same scenario using one of three approaches:
- You can call the OpenAI APIs directly:
- Run src/1_openai/init_search_1.py by opening the file and pressing F5. This initializes an Azure Cognitive Search index with our data.
- Run src/1_openai/main_1.py. This runs a sequence of queries using our data.
- You can use the LangChain package:
- Run src/2_langchain/init_search_2.py.
- Run src/2_langchain/main_2.py.
- You can use the Semantic Kernel package:
- Run src/3_semantic_kernel/init_search_3.py.
- Run src/3_semantic_kernel/main_3.py.