- This video explains the core concepts of OAIZ, one at a time. Workflows, knowledge documents, databases and apps.
Start here
The core concepts
Workflows, knowledge documents, databases and apps, with one Fjord Living example each.
Workflows
Jobs linked by events
Knowledge documents
What jobs and Chat follow
Databases
Data kept between runs
Apps
Pages on your data
- A workflow is a set of jobs, linked by events.
- An event records something that happened. Maya's email to Fjord Living arrives as the event Email received.
- A job waits for one type of event, then runs one action. Here, an LLM call writes a reply to Maya.
- When the action finishes, the job can publish a new event, Reply written.
- That event starts the next job, which saves the reply as a draft for Sam to check.
A workflow is jobs linked by events
An event is something that happened
A job waits, then runs one action
The job publishes a new event
That event starts the next job
Email received
Write a reply to the customer that follows the Returns policy.
Save the reply as a draft for Sam to check.
Maya Chen
Cracked lamp shade, order 4821
1Waits for
Email received
2Runs one action
LLM Call
Writes a reply to Maya
3Publishes an event
Reply written
4Starts the next job
Saves a draft for Sam
- A knowledge document holds written instructions or reference text. Fjord Living keeps its Returns policy in one.
- Attach it to the job that writes replies. The model reads the policy each time the job runs, so the reply follows it.
- Chat can follow it too. Tag the document in your message, and Chat reads it along with your question.
- When the policy changes, you edit the document once. Every job that uses it reads the updated version on its next run.
A knowledge document holds what you know
A job follows it
Chat follows it too
Change it once
Returns policy
Knowledge document
Damaged items: send a free replacement within 2 days.1 day.
The customer keeps the damaged item.
Tone: warm, short, first name.
Version saved
Write a reply to the customer that follows the Returns policy.
Knowledge documents
Returns policy
Reply to Maya
A replacement shade for order 4821 is on its way within 2 days. Please keep the cracked one.
What do we offer when an item arrives damaged?
A free replacement within 2 days, and the customer keeps the damaged item.
Returns policy
Type or @ to tag
Write a reply to the customer that follows the Returns policy.
Answer the team's questions about returns.
Returns policy
Returns policy
- Each run works from the event that started it. To keep data from one run to the next, you use a database.
- A database holds tables. Fjord Living keeps a Refund requests table, with one row for each request.
- When Maya writes in, a Write to database job adds her request for order 4821 to the table.
- When she writes again that afternoon, a Query database job finds the row, so the reply can say where her request stands.
Keep data between runs in a database
A database holds tables
One run writes a row
A later run reads it
Maya Chen
Cracked lamp shade
Maya Chen
Any news on my shade?
Refund requestsrefund_requests
OrderCustomerStatus
4790Jonas Bergapproved
4805Lena Ortizopen
4812Klara Vogelopen
4821Maya Chenopen
Add the request to Refund requests.
Look up the customer's earlier refund requests.
Adds order 4821
Finds order 4821
Status open
- An app is a small web page with its own address, built on your data.
- Sam describes one in Chat. List the open refund requests, with an Approve button on each.
- Chat writes the page, and a live preview beside it shows the result.
- Sam shares it with the team, and they sign in with their OAIZ accounts.
- When Sam approves Maya's request, the app changes her row. A live workflow that listens for that change sends her the reply.
An app is a page on your data
Describe it in Chat
Chat writes the page
Your team signs in
A change can start a workflow
List the open refund requests, with an Approve button on each.
Working..
Completed · 3 steps
The page lists each open request with an Approve button.
Type or @ to tag
Support team
SHSam HolmSigned in
ONOla NordSigned in
NLNora LindSigned in
RefundsLive workflow
Listens for changes to Refund requests
Send the customer the reply about the refund.
Open refund requests3 open
OrderCustomerReason
4821Maya ChenCracked shadeApproveApproved
4812Klara VogelWrong sizeApprove
4805Lena OrtizArrived lateApprove
- Workflows do the work. Knowledge documents guide it. Databases keep data between runs, and apps put it on a page for your team.
- Each concept has its own series under Core concepts, and its own page in the docs.
Four core concepts
Each one has its own series and docs page
Workflows
Do the work
SeriesWorkflows
DocsWorkflows
Knowledge
Guide the work
SeriesKnowledge
DocsKnowledge documents
Databases
Keep data between runs
SeriesDatabases
DocsDatabases
Apps
Put data on a page for your team
SeriesApps
DocsApps