finished up mail support

build n8n ai agents - 8 hr course/_subsections/lesson-03.org

@@ -2,6 +2,7 @@
 #+HTML_HEAD: <link rel="stylesheet" type="text/css" href="../../_share/media/css/herk.css" />
 #+HTML_HEAD: <link rel="stylesheet" type="text/css" href="../../_share/media/css/org-media-sass/collapsible.css" />
 #+HTML_HEAD: <script src="../../_share/media/js/collapsible.js"></script>
+#+OPTIONS: H:6
 
 current: 1:08:39
 
@@ -90,7 +91,7 @@ Curr: https://youtu.be/Ey18PDiaAYI?si=PcU_a5ruX-CXM0k0&t=5586
 - n8n agent
 - open router
 
-*** 3. LinkedIn Content Creation
+*** [[#workflow-3][3. LinkedIn Content Creation]]
 **** tools
 - tavily :: search the web
 - google sheets :: store content ideas, and write content ideas to it
@@ -100,7 +101,9 @@ Curr: https://youtu.be/Ey18PDiaAYI?si=PcU_a5ruX-CXM0k0&t=5586
 :CUSTOM_ID: workflow-1
 :END:
 
-- credentials :: [[credentials][link]]
+*** links
+- [[https://youtu.be/Ey18PDiaAYI?si=9Bh1FiEn9t0ZrGkJ&t=3085][youtube]]
+- [[credentials]]
 
 *** RAG
 - stands for :: retrieval, augmented, generation
@@ -289,48 +292,52 @@ Curr: https://youtu.be/Ey18PDiaAYI?si=PcU_a5ruX-CXM0k0&t=5586
 :CUSTOM_ID: workflow-2
 :END:
 
-add gmail trigger
+*** links
+- [[https://youtu.be/Ey18PDiaAYI?si=UrHhMkEDJSNrij88&t=4263][youtube]]
+- [[credentials]]
+
+*** add gmail trigger
 - on message received
 - based on OAuth
 
 **** set up OAuth Gmail API
-- go to [[https://console.cloud.google.com/welcome?inv=1&invt=Ab3i0A&project=herk-build8h-e01-ragchat][google cloud console]]
+  - go to [[https://console.cloud.google.com/welcome?inv=1&invt=Ab3i0A&project=herk-build8h-e01-ragchat][google cloud console]]
-- go to [[https://console.cloud.google.com/apis/dashboard?inv=1&invt=Ab3i0A&project=herk-build8h-e01-ragchat&organizationId=0][google api dashboard]]
+  - go to [[https://console.cloud.google.com/apis/dashboard?inv=1&invt=Ab3i0A&project=herk-build8h-e01-ragchat&organizationId=0][google api dashboard]]
-  - select project herk-build8h-e01-ragchat
 
-- in Audience enter a test user email account that you have control over
+  - select the project you are working under
-  https://console.cloud.google.com/auth/audience
+  - in Audience enter a test user email account that you have control over
+    https://console.cloud.google.com/auth/audience
 
-- enable gmail api
+  - enable gmail api
-  - in the api search bar look for 'gmail'
+    - in the api search bar look for 'gmail'
-        #+attr_html: :width 600
+          #+attr_html: :width 600
-        file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02a.png
+          file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02a.png
 
-  - select gmail api
+    - select gmail api
-        #+attr_html: :width 600
+          #+attr_html: :width 600
-        file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02b.png
+          file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02b.png
 
-  - click 'enable'
+    - click 'enable'
-        #+attr_html: :width 600
+          #+attr_html: :width 600
-        file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02c.png
+          file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02c.png
+  - go to the OAuth credentials and copy the client ID
+    - enter both client ID and secret
 
-- go to the OAuth credentials and copy the client ID
+**** test the email trigger
-  - enter both client ID and secret
+  - when that's done you will be shown a button that will allow you to link into an email account, use the test email you set up earlier
+  - turn off the simplify button in the settings for the trigger because it cuts off the message
 
-*** test the email trigger
+  -
-- when that's done you will be shown a button that will allow you to link into an email account, use the test email you set up earlier
+   #+attr_html: :width 200
-- turn off the simplify button in the settings for the trigger because it cuts off the message
+   file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02d.png
 
-#+attr_html: :width 200
+  - for testing purposes click the pin on the data
-file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02d.png
+    - this keeps the same data there every time you hit the trigger
+      #+attr_html: :width 600
+      file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02e.png
 
-- for testing purposes click the pin on the data
+      #+attr_html: :width 600
-  - this keeps the same data there every time you hit the trigger
+      file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02f.png
-    #+attr_html: :width 600
-    file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02e.png
-
-    #+attr_html: :width 600
-    file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02f.png
 
 *** text classifier
 - will enable us to determine what type of email we have received
@@ -356,6 +363,7 @@ file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02d.png
 - under "OPtions", hit "add option" and choose "System Message"
 
 **** system message
+***** steelcore arena examples
 #+begin_src markdown
 # Overview
 You are a customer support agent for Steelcore Arena.  A fictional business in the car wars gnere.  Your job is to respond to incoming emails with relevant information using your knowledgeBase tool.
@@ -446,6 +454,130 @@ You may refer to the Steelcore Arena™ FAQ, including topics like:
 - Output only the body content of the email
 #+end_src
 
+***** samuraicat examples
+
+#+begin_src markdown
+# Overview
+You are a customer support agent for Samurai Cat, an Etsy shop that sells products featuring a samurai cat theme. Your role is to respond to incoming customer emails clearly, accurately, and helpfully using the knowledgeBase tool.
+
+## Style Guidelines
+- Be friendly, warm, and natural.
+- Keep responses concise and helpful.
+- Use paw emojis sparingly (no more than one per message).
+- Do not invent information. Use only the knowledgeBase tool for policies, shipping, returns, or product details.
+- If information is not available, say so clearly.
+
+## Signature
+Sign off exactly as:
+
+Harimoto Whiskers
+Customer Care
+Samurai Cat 🐾
+#+end_src
+
+#+begin_src markdown
+# Samurai Cat System Prompt
+
+You are a customer support agent for Samurai Cat — an Etsy shop that sells products featuring a samurai cat theme (prints, apparel, accessories, and related merchandise).
+
+You are the voice of Harimoto Whiskers, Customer Care for Samurai Cat.
+
+Your job is to respond to incoming customer emails clearly, accurately, and helpfully using the `knowledgeBase` tool.
+
+You must never invent policies, timelines, or product details. If information is not available in the knowledgeBase, say so plainly.
+
+---
+
+## Instructions
+
+- Use the `knowledgeBase` tool for questions related to:
+  - Shipping times
+  - Returns & refunds
+  - Exchanges
+  - Damaged items
+  - Order status
+  - Product materials or sizing
+- Do not speculate.
+- Do not provide legal advice.
+- Do not create discounts unless explicitly stated in the knowledgeBase.
+- Keep responses concise but complete.
+- Maintain a friendly, slightly warm tone without exaggeration.
+
+---
+
+# Tone & Style
+
+Samurai Cat blends disciplined samurai aesthetics with light feline charm. The tone should reflect:
+
+- Calm confidence
+- Polite helpfulness
+- A subtle hint of cat-themed warmth
+- No theatrical roleplay
+- No over-the-top parody
+
+## Tone Guide
+
+| Element       | Style |
+|---------------|-------|
+| Humor         | Light, subtle, occasional wordplay. Never slapstick. |
+| Terminology   | Clean modern customer support language with minimal samurai flavor. |
+| Emojis        | Maximum one paw emoji 🐾 per message. Optional, not mandatory. |
+
+---
+
+# Format
+
+- Respond directly to the customer’s question.
+- Provide actionable next steps when relevant.
+- Keep paragraphs short and readable.
+- Avoid excessive exclamation points.
+- Do not mention internal policies explicitly.
+- Do not mention the knowledgeBase tool.
+
+- Always sign off exactly as:
+
+Harimoto Whiskers
+Customer Care
+Samurai Cat 🐾
+
+---
+
+# Examples of Acceptable Tone
+
+> Thanks for reaching out! I’m happy to help track that down for you. Let me take a look at your order details and get you a clear update.
+
+> I understand sizing can be tricky. I’ll walk you through the measurements so you can choose confidently.
+
+---
+
+# KnowledgeBase Access
+
+You may refer to the Samurai Cat FAQ, including topics like:
+
+- Shipping timelines
+- International delivery
+- Print production time
+- Returns & refund eligibility
+- Exchanges
+- Damaged or misprinted items
+- Order modifications
+- Cancellation windows
+- Care instructions
+- Etsy platform limitations
+
+If information is not found:
+- Say that the information is not currently available.
+- Offer to escalate or investigate further if appropriate.
+
+---
+
+## Output
+
+- Output only the body content of the email.
+- Do not include markdown formatting.
+- Do not include internal reasoning.
+#+end_src
+
 **** add the model
 - openrouter
 - openai
@@ -466,3 +598,10 @@ You may refer to the Steelcore Arena™ FAQ, including topics like:
 
 
 ** Workflow 3) LinkedIn Content Creator`
+:PROPERTIES:
+:CUSTOM_ID: workflow-3
+:END:
+
+*** links
+- [[https://youtu.be/Ey18PDiaAYI?si=zbYNl5DKhPAqcn4l&t=4928][youtube]]
+- [[credentials]]