compsci_ai_herk/build n8n ai agents - 8 hr course/_subsections/lesson-03.org
2026-03-03 15:14:51 +02:00

16 KiB
Raw Blame History

Lesson 03 | data types

current: 1:08:39

credentials

OAuth App

project
herk-build-n8n
app name

ronnyabraham-tutorials-herk-n8n

email
this.ronny@gmail.com
audience
external

OAuth client

client name
herk-n8n-tutorial-pi
client id
418038224272-v1h0js2kh86gqc7vtdt9sib8euht6t8u.apps.googleusercontent.com
client secret
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
file
client secret

pinecode

openrouter

link
https://openrouter.ai
herk-build_n8n-e01_ragchat
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

Notes

set field

  • can also name the fields and data type for each field

data types

data type symbol example
String A "blah"
Number # 50
Boolean true
Array [1, "one", "three"]
Object 3d box {"blah": 33}

3 AI workflows

1. RAG pipeline & chatbot

tools
pinecone
vector database
google drive
data storage
google docs
open router
lets us connect to ai models like openai's or anthropics

2. Customer support

purpose
  • build off prev workflow with pinecone db
  • respond to customer support related emails
tools
  • pinecone
  • gmail
  • n8n agent
  • open router

3. LinkedIn Content Creation

tools
tavily
search the web
google sheets
store content ideas, and write content ideas to it

Workflow 1) - Rag Pipeline and Chatbot

credentials
link

RAG

stands for
retrieval, augmented, generation
?
looks inside database for the answer
Vector Database
  • multidimensional graph of points
  • vector is placed based on meaning of vector

    • ie, wolf and dog will be close
    • banana, apple will be close
how it works
  • we have a document
  • break it into chunks
  • run it through an 'embeddings model'

    • this puts the chunks into a vector model
Query
  • run the query through the embeddings model
  • see where it lands in vectors, grabs back the nearest 4 or 5 vectors and returns it to us

process

  • our trigger is any changes in folder on google drive

set up google drive trigger

  1. create OAuth Credentials n8n documentation for creating OAuth credentials
  2. in Client, make sure to add the OAuth Redirect URL found in the trigger set up to Clients->Authorized Redirect URIs

    /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/get%20redirect%20from%20trigger.png
    get the OAuth redirect from the n8n google drive trigger settings
    /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/add%20authorized%20redirect.png
    put the redirect url in google client settings
  3. get client id and secret id, and enter into the trigger

  4. add the google drive api

    • APIs

      • go to google api dashboard and enable the following apis

        • google drive api
        • google drive activity api
    • API scopes

      • go to google api dashboard
      • from the left hand menu, select OAuth consent screen
      • from the left hand menu, select Data Access
      • at the top of the page click the "Add or remove scopes" button

        • search through it until you find

          • /auth/drive.readonly
          • /auth/drive.appdata
    • Sign in and grant the user permission for the following

      • See, edit, create, and delete all of your Google Drive files
      • See, create, and delete its own configuration data in your Google Drive
    • if you have to reconnect from scratch, go to

    • if all goes well

      • set folder
      • save and exit the config dialog
      • go to google drive trigger, and select the folder

set up google drive download file

current files:
setup
  • in order to put documents into our Pinecone vector database we need to check for a newly created file, download it, and then send it
  • so we must create an initial file, from which we will get the necessary id that we will always look for in all new files, and then tell this tool to download it
  • create a file

    • first create a new faq file in the folder
    • fetch it from google trigger
    • find where the name of the file is in the schema, you will be getting the id field next to it
  • now add google drive - download file
  • look for where name was in the fetch, drag the id link to the file field

    /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/drag%20id.png
    drag the id to the file field

pinecone

set up pinecone
  • got to http://pinecone.io
  • create an index

    • give it a name
    • choose a text embedding model

      • in this case it is 'text-embedding-3-small'
    • set the embeddings to 1536

      /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/pinecone%20set%20embeddings.png
      set the embedddings
    • hit 'create index'
  • go to API keys and create a key
add pinecone node
  • search for pinecode vector store
  • choose 'add documents to a vector store'

    • add the api key
    • after you save it go to settings pinecone index and choose the index you created

      /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/set%20pinecone%20index.png
      set pinecone index in the node
  • add option 'pinecone namespace'

    /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/add%20pinecone%20option.png
    add option 'pincone namesapce'
  • decide on a namespace and give it

    • pinecone can just use the default location for all data
    • namespaces allow you to organize data in pinecode
  • at this point you need an embeddings model and a document loader
embeddings model
  • add embeddings open ai
document loader
  • add default data loader
  • choose binary as the data type
  • add a recursive character test splitter
run pinecone node by clicking play

add a second workflow to access the information

  • we are going to use open router to choose any LLM
add an agent to process
  • create an agent with a chat trigger
  • source for prompt is the chat trigger node
  • to make the response sound correct

    • add a system message

      • in the agent node click 'OPTIONS'
      • select "System Message"
    • add the following text:

            You are the official support assistant for Samurai Cat.
            Answer questions using ONLY the retrieved policy text.
            Respond in first person (“we”, “our”), never in third person.
            Do not analyze tone.
            Do not describe the document.
            Do not say “the document states” or “they say”.
            If the information is not found in the knowledge base, say you dont have that information.
      
            Keep responses clear, concise, and professional.
open router
add pinecone tool
  • add pinecone as a tool

    • NOTE: MAKE SURE YOU USE THE TOOL CONNECTOR!!
    • /notes/compsci_ai_herk/media/commit/3c75ca457c10418f75852bfe6db2f5491a5b4aa9/_share/media/img/build_n8n/chap03/ragchat/pinecone%20-%20connect.png
      set the embedddings
  • hit the tool extension and pick pinecone vector store
  • add an embedding node (open ai embedding) so the pinecone node can convert the question text to a vector that it will then process to retrieve the associated vector for that text

Workflow 2) Customer Support

add gmail trigger

  • on message received
  • based on OAuth
set up OAuth Gmail API
  • go to google cloud console
  • go to google api dashboard

    • select project herk-build8h-e01-ragchat
  • in Audience enter a test user email account that you have control over https://console.cloud.google.com/auth/audience
  • enable gmail api

    • in the api search bar look for 'gmail'

      file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02a.png

    • select gmail api

      file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02b.png

    • click 'enable'

      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

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
  • 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

  • for testing purposes click the pin on the data

    • this keeps the same data there every time you hit the trigger

      file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02e.png

      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
  • to set it up connect a chat model (openrouter)
  • now open up the settings for text classifier and add text variable to 'text to classifiy'

    file:../../_share/media/img/compsci/ai/herk/build_8hr/ch03_e02g.png

  • add categories

    customer support
    an email that is related to helping out a customer. They may be asking questions about our policites or questions about our products or services.
    other
    any email that is not customer support related
  • once you add categories, branches coming out of the node will represent each category

add an ai agent

  • to the category for customer support add an ai agent
  • set "source for prompt" to "define below"
  • drag the text variable into the Prompt(User Message) field
  • under "OPtions", hit "add option" and choose "System Message"
system message
# 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.

## Instructions
- your output should be friendly and use emojis
- Sing off as Mr. Helpful from Steelcore Arena
# Steelcore Arena™ System Prompt
You are a customer support agent for Steelcore Arena™ — a fictional company set in a futuristic vehicular combat universe inspired by the *Car Wars* genre. You are the voice of Mr. Helpful, an overly enthusiastic, slightly sardonic, and deeply loyal representative of the Arena.

 Your job is to respond to incoming emails with relevant information using your `knowledgeBase` tool.

This is a **game universe**, not real life. The tone should reflect the *tongue-in-cheek humor* and dystopian flair of the Car Wars setting while remaining friendly and accessible.

---

## Instructions

- Always respond **in character** as a helpful but cheery support rep from a high-octane autoduel league.
- Use **casual, humorous language** with sci-fi flavor.
- **Include emojis** that match the tone (e.g., 🚗💥📡💀).
- **Sign off as**: `Mr. Helpful from Steelcore Arena™`
- Emphasize that **Steelcore Arena™ is fictional** and all answers are for entertainment.

---

# Tone & Style
- Use **tongue-in-cheek humor** in the spirit of *Car Wars* (think darkly comedic, corporate absurdity meets brutal sport).

- Make it **clear this is a game**, not a real organization or real-world advice.
- Be **friendly**, **entertaining**, and **just a bit too excited** about dangerous things.
- Use appropriate emojis to enhance engagement 💥🚗🔧📺💀.


## Tone Guide

| Element              | Style                          |
|----------------------|---------------------------------|
| Humor                | Tongue-in-cheek, satirical     |
| Terminology          | In-universe (e.g. kill-dome, CoreBet™, neural-state) |
| Emojis               | Use where helpful or silly     |
| Realism disclaimer   | Light reminder: it's a game!   |

---

# Format
- Respond to customer inquiries with **useful and entertaining** answers drawn from your FAQ and knowledgeBase.
- **Always sign off as "Mr. Helpful from Steelcore Arena™"**.
- Never suggest real-world violence or imply this is an actual organization.
---

# Examples of Acceptable Tone
> "Sure! You *can* put a railgun on a SmartCar... but you'll need to clear that with your insurance AI first. 😎"

> "Remember: cheating is forbidden, unless you're really good at it and don't get caught. (Kidding! Mostly.) 😉"

---

# KnowledgeBase Access
You may refer to the Steelcore Arena™ FAQ, including topics like:
- What is Steelcore Arena™
- Driver requirements
- Tier breakdowns
- Weapon legality
- Match rules
- Vehicle construction
- Resurrection clauses (yes, really)
- Betting protocols
- Fan participation options

---

### Example Sign-off:

> Stay sharp and watch your six,
> **Mr. Helpful from Steelcore Arena™** 🚗💥

> If you're still on fire, please contact our Pyrotechnics Safety Team (and stop hugging the plasma core).
> **Mr. Helpful from Steelcore Arena™** 💀💬🔥

---

## Output
- Output only the body content of the email
add the model
  • openrouter
  • openai
add the database
  • under tool
  • add pinecone database

    operation mode
    retrive documents (as tool for AI Agent)
    name
    knowlegebase
    description
    call this tool to access Policy and FAQ information
    options->add option->Namespace
    FAQ
embeddings model
  • add to the pinecoen
  • 'embeddings openai'

add gmail reply

Workflow 3) LinkedIn Content Creator`