Wiki

Deze pagina is alleen-lezen. Je kan de broncode bekijken maar niet veranderen. Neem contact op met de beheerder als je denkt dat dit niet klopt.
====== A3D AI Template ======

🗂️ [[start|Terug naar start]]\\

🃏 [[steamlit_home#streamlit_app_template|Naast deze template is er ook een basis streamlit template met dynamische content lader, pagina's en zijpaneel menu.]]

🚧 **Onder Constructie**\\
Ik heb een [[https://github.com/AdrieVanDijke/a3dsysteemtemplate|Python project aangemaakt op GitHub]] waar ik een template wil maken om snel en simpel een AI gestuurde applicatie mee te kunnen bouwen. Diverse onderdelen worden als modules pas geladen als ze nodig zijn om de applicatie zo ligt mogelijk te houden. Er zijn verschillende voorbeelden ingebouwd als [[#modules|aparte modules]]. 

Gebruikte software en bibliotheken:

🔸 [[python|Python]]\\
🔸 [[ai-ki#openai|OpenAI]]\\
🔸 [[longchain_home|LangChain]]\\
🔸 [[langgraph|LangGraph]]\\
🔸 [[langsmith|LangSmith]]\\
🔸 [[steamlit_home|Streamlit]]

 
**Project op GitHub**\\
[[https://github.com/AdrieVanDijke/a3dsysteemtemplate|A3D AI Template: GitHub Opslagplaats (a3dsysteemtemplate)]]

----

===== Het Idee =====

Het idee achter dit project is om een online applicatie te bouwen die opgebouwd is uit verschillende modules. De applicatie maakt gebruik van Streamlit om de gebruikersinterface te maken. Om de applicatie zo snel //(ligt)// mogelijk te houden wordt een module pas geladen als deze echt nodig is. De modules op zich zijn losse onderdelen die gebruik maken van verschillende technieken en bibliotheken die ik op deze manier wil leren kennen/gebruiken. Voor mij is het dus leer, test en naslagmateriaal. I.v.m. tijdgebrek zal de uitleg summier zijn maar ik denk dat de code best wel begrijpelijk/logisch ingedeeld is. De applicatie is zo veel mogelijk OOPS opgebouwd met classes //(klassen)//.

[[https://github.com/AdrieVanDijke/a3dsysteemtemplate|Het "A3D AI Template" project op GitHub]]

----

===== Modules =====

Ik heb in de applicatie verschillende modules ingebouwd die via het zijpaneel zijn op te starten. Ik heb de modules gemaakt met het doel diverse onderdelen te testen en "onder de knie" te krijgen. De modules zijn zo opgezet dat ze met zo weinig mogelijk inspanning op te pakken en aan te passen zijn. Alle modules zijn verdeeld in verschillende Classes. Onderdelen worden pas dynamisch geladen op het moment dat ze daadwerkelijk nodig zijn.

🔓 Alle modules zijn getest en zullen werken zodra je de keys en andere os variabelen hebt aangepast in het .env en .streamlit/secrets.toml bestand //(pas de naam van de bestanden aan door de toevoeging "_template" in beide bestandsnamen weg te halen)//

**Alle modules zijn opgebouwd met minimaal 2 onderdelen //(bestanden)//:**\\
🔹 De View: Streamlit GUI: Die wordt geladen vanuit app.py n.a.v. de waarde in "st.session_state['appState']"\\
🔹 De Controler: De logica van de module. De controler wordt gestart vanuit de view en verwerkt de vraag of opdracht van de gebruiker\\
//De Controler wordt altijd gestart door vanuit de view de run functie in de controler aan te roepen.//

**Views:**\\
Alle views zijn op de zelfde manier opgebouwd. Na het initialiseren worden twee view functies uitgevoerd die samen de gehele GUI bouwen. Eerst wordt in de "buildSidebarView" functie het zijpaneel gebouwd en daarna in de "buildMainView" functie het hoofd GUI gedeelte van de module. Onder de view functies zijn de "Workers" te vinden. Dat zijn functies die op de een of andere manier onderdelen van de view laden of opslaan.

**Controlers:**\\
Alle Controlers hebben een init, reset en run functie. Daaronder zijn de Workers van de controler te vinden. De actie van de controler wordt altijd gestart door vanuit de view de run functie in de controler aan te roepen.

🪄 **Omdat de views en de controllers altijd de zelfde format hebben en op de zelfde manier zijn ingericht zijn deze heel makkelijk en snel aan te passen om desgewenst een nieuwe OOPs module te bouwen**.

----

==== 🤖 Basic AI Chatbot Module ====

[[https://github.com/AdrieVanDijke/a3dsysteemtemplate/blob/main/a3d/controlers/c_basic_chat.py|Deze Module]] is een simpele chatbot met een geheugen en een systeemprompt die gebruik maakt van de OpenAI API. De systeemprompt is //(voor testdoeleinden)// in het zijpaneel //(tijdelijk)// aan te passen.

----

==== 🧮 Simple Graph Module ====

[[https://github.com/AdrieVanDijke/a3dsysteemtemplate/blob/main/a3d/controlers/c_simple_graph.py|Deze module]] heb ik gebouwd om [[langgraph|LangGraph]] **State** te testen in een [[steamlit_home|Streamlit]] omgeving. Ik heb de code die hier in [[https://www.youtube.com/watch?v=BDFP6VSOARk|deze video]] wordt besproken daarvoor aangepast. Het punt is dat Streamlit iedere keer als er een actie //(zoals een knop klik)// plaats vind de gehele aplicatie opnieuw geladen wordt. Dit maakt het noodzakelijk om in een Streamlit applicatie gebruik te maken van [[https://docs.streamlit.io/develop/api-reference/caching-and-state/st.session_state|st.session_state]] om o.a. het geheugen en de StateGraph op te slaan.

[[https://www.youtube.com/watch?v=BDFP6VSOARk|Youtube: LangGraph State in Less Than 10 Minutes - Orginele tutorial]]\\
[[https://github.com/aidev9/tuts/blob/main/langgraph/state/tutorial-1/state.py|Orginele code op GitHub]]


----

==== ♻️ ReAct Agent ====

[[https://github.com/AdrieVanDijke/a3dsysteemtemplate/blob/main/a3d/controlers/c_react_agent.py|Deze module (LangGraph ReAct Mini Agent)]] maakt gebruik van tools. Er zijn diverse reken tools en er is een zoek tool die gebruik maakt van de DuckDuckGo tool. Als er een vervolgvraag wordt gesteld, wordt van de laatste vraag en het antwoord daarop een samenvatting gemaakt en als een string //(met de nieuwe vraag daarin verwerkt)// als nieuwe vraag naar de ReAct Agent //(llm)// gestuurd. De module is gebaseerd op: 

[[https://www.youtube.com/watch?v=pEMhPBQMNjg|Youtube: Building a LangGraph ReAct Mini Agent - Orginele tutorial]]\\
[[https://colab.research.google.com/drive/14ncV0nviLcP9IDzmFSRGSXb7Bgpz212v?usp=sharing|LangGraph ReAct Function Calling Pattern]]

----

==== 🗄️ Embedding ====

[[https://github.com/AdrieVanDijke/a3dsysteemtemplate/blob/main/a3d/controlers/c_embedding.py|Deze module (Embedding)]] laad de content van .txt bestanden uit de map "files/to_db/" in en embed de conntent in een Pincone database.

📝 De content in de .txt bestanden zijn stukken tekst die per onderwerp speciaal zijn geschreven om zonder ruis en dataverlies stukken tekst te kunnen embedden.\\
📝 De tekst is opgedeeld in stukken van tussen de 1000 en 2000 lettertekens (inclusief spaties) en gescheiden door een dubbele zachte enter, Daar wordt in het script de tekst ook op gesplitst.\\
📝 Een voorbeeld van de indeling van de tekst in de .txt bestanden is te vinden in het voorbeeld bestand: files/to_db_collection/voorbeeld.txt"\\

⚠️ De manier van teksten maken is behoorlijk tijdrovend maar zeer doeltreffend!

----

==== 😺 CATja RAG Chatbot ====

🔸 CATja //(de CATviseur)// is een AI chatbot die in de productieomgeving van kwaliteitsysteem.nl draait met als doel vragen van therapeuten die een account hebben in deze omgeving te beantwoorden.\\
🔸 De RAG Chatbot haalt informatie //(op verschillende manieren)// uit een [[https://docs.pinecone.io/guides/get-started/build-a-rag-chatbot|Pinecone database]] en stuurt de resultaten door naar een llm om een antwoord te creëren.\\
🔸 De documenten die worden opgehaald in de database zijn de documenten die eerder door de [[#🗄%EF%B8%8F_embedding|🗄️ Embedding module]] in de database zijn gezet

[[https://kwaliteitsysteem.nl/kennisbank/doku.php?id=catviseur|Meer over deze applicatie in de kennisbank van kwaliteitsysteem.nl]]


----

==== 👥 Multi Agents ====

Test Module met meerdere samenwerkende AI Agenten. Kijken hoever we hier mee komen en at we er mee kunnen doen. Hier eerst wat bronnen die ik voor deze module heb gebruikt:

[[https://langchain-ai.github.io/langgraph/tutorials/introduction/|LangGraph Quick Start Tutorials]]


----


==== 💶 E-boekhouden test ====

Een simpele test met de API van e-boekhouden. Haalt alle facturen van een bepaalde relatie op. Gebruikt geen AI

----