genai doc

Author: valhuber

docs/Sample-Genai.md

@@ -0,0 +1,91 @@
+!!! pied-piper ":bulb: TL;DR - GENAI leverages AI for 'hands-free' project creation"
+
+    ChatGPT APIs enable API Logic Server to submit prompts and obtain data model class responses.  
+    
+    API Logic Server can use these to create databases and projects, from single command.
+
+## Project Creation
+
+You can explore genai using the [Manager](Manager.md){:target="_blank" rel="noopener"}.  Optionally, you can sign-up for ChatGPT API and Copilot, or simulate the process as described below.
+
+1. If you have signed up for , this will create and open a project called `genai_demo` from `genai_demo.prompt`:
+
+```bash
+als genai --using=genai_demo.prompt
+```
+
+
+2. ***Or,*** you can simulate the process using:
+
+
+```bash
+als genai --using=genai_demo.prompt --gen-using-file=system/genai/temp/chatgpt_retry.txt
+```
+
+ 
+
+## What Just Happened?
+
+`genai` processing is shown below (internal steps denoted in grey):
+
+1. You create your.prompt file, and invoke `als genai --using=your.prompt`.  genai then creates your project as follows:
+
+    a. Submits your prompt to the `ChatGPT API`
+
+    b. Writes the response to file, so you can correct and retry if anything goes wrong
+
+    c. Extracts model.py from the response
+
+    d. Invokes `als create-from-model`, which creates the database and your project
+
+2. Your created project is opened in your IDE, ready to execute and customize
+
+ 
+
+![Microservice Automation](images/sample-ai/copilot/genai.png)]
+
+
+ 
+
+## AI somtimes fails - here's how to recover
+
+AI results are not consistent, so the model file may need corrections.  You can find it at `system/genai/temp/model.py`.  You can correct the model file, and then run:
+
+```bash
+als create --project-name=genai_demo --from-model=system/genai/temp/model.py --db-url=sqlite
+```
+
+Or, correct the chatgpt response, and
+
+```bash
+als genai --using=genai_demo.prompt --gen-using-file=system/genai/temp/chatgpt_retry.txt
+```
+
+We have seen failures such as:
+
+* duplicate definition of `DECIMAL`
+* use of `Decimal` vs. `DECIMAL` (latter required, work-around in place)
+* unclosed parentheses
+* data type errors in test data creation
+* wrong engine import: from logic_bank import Engine, constraint
+* bogus test data creation: with Engine() as engine...
+* Numeric --> String (fixed product bug)
+* Bad load code (no session)
+
+
+ 
+
+**Postgresql Example**
+
+You can test this as follows:
+
+1. Use [our docker image](Database-Docker.md){:target="_blank" rel="noopener"}
+2. And:
+
+```bash
+als create --project-name=genai_demo_pg.prompt --db-url=postgresql://postgres:p@localhost/genai_demo
+```
+
+Provisos:
+
+* You have to create the database first

docs/images/sample-ai/copilot/genai.png

@@ -23,8 +23,9 @@ nav:
         - Execute From Terminal: Execute.md
     - Express Eval (unavail): Install-Eval.md
   - Demos, Tutorial, Samples:
-    - "AI Demo": Sample-AI.md
+    - "Generative AI Demo": Sample-Genai.md
     - "Tutorial": Tutorial.md
+    - "AI Demo": Sample-AI.md
     - "Sample DB, Project": Sample-Database.md
     - "Sample Integration": Sample-Integration.md
     - "Sample DB, Project": Sample-Database.md