3️⃣ Hands-on Practice - The AI Block

🧠 How the AI Block Works

Before going further, we're going to quickly revisit the operating principle of generative AI and how it applies in Thinkeo.

🤖 Understanding Generative AI

When you use a chatbot like ChatGPT, Claude, or Le Chat, you're using generative AI.

This AI relies on a knowledge base, the result of training on a large amount of existing data, and will use a language model to respond to your requests. It's an autocompletion logic where the AI will predict the words and phrases to use according to the context and what seems coherent in relation to your request. In other words, it will anticipate a response like a phone anticipates a word and suggests it to you when writing a message, but in a much more advanced way. Generative AI isn't intelligent per se - it performs deduction in an impressive way. It's a digital Sherlock Holmes.

📝 Understanding Prompts

When you chat with an AI to ask it a question, you create what's commonly called a "prompt". This prompt is the set of instructions, guidelines, and phrases you give it as guidance so it generates content for you.

In summary: When using conversational AI like ChatGPT, you exchange prompts (your requests) and responses (the content it generates) throughout a discussion.

🔄 How This Works in Thinkeo

On Thinkeo the principle is the same except that the interface is not conversational - here you're going to prepare a prompt on your AI block so it creates the expected content without the user of your App needing to discuss with the AI.

Your AI block will contain a prompt, and when the wizard tells the block to "execute", this prompt will be sent to the AI which will then return its response. This response will be the generated content for the document.

This approach enables:

Defining a prompt to ensure the result will always be adapted to the document

Avoiding the need for users to discuss with the AI and iterate extensively to get a good result

Preparing and organizing the information the AI will have available

Framing content generation so it's always relevant

All nested blocks of an AI block constitute its prompt.

All these blocks will be instructions and information made available to the AI to generate its response.

⚙️ AI Block Configuration

In our App, the prompt of our AI block will consist of the instructions from the paragraph block "DS. P. Summary" and the document from the file block "DS. F. Document".

WARNING

Critical Understanding: While we generally talk about "prompt" referring only to the paragraph block with the main instructions, this is a simplification. It's actually the entire set of nested blocks that constitutes the prompt.

✍️ Writing the Instructions

Understanding Best Practices

Generative AIs will give much better results with structured prompts and explicit formulations. For more information on some good prompting practices, we invite you to consult this documentation.

For this App, we'll use a simple prompt, though well-structured.

Write the Prompt

You can click directly on your paragraph block in the central panel of the Studio and write a prompt of this type:

Role: You are a general engineer, capable of analyzing documents on all subjects with precision.

Objective: Analyze the provided document to write a detailed summary.

Detail this analysis point by point.

Points to identify:
- Document objective  
- Key points, important elements
- Points of vigilance, if any
- What is essential to remember about this subject

Formatting: Bold the title of each point to identify.

Language: Professional and clear. Be precise.

Information provided:
The document to analyze is:

Understanding the Structure

In this prompt, we've structured the AI's thinking by indicating a context and clearly distinguishing the instructions by theme.

You'll notice that we end this prompt with an "Information provided" section for a good reason - the AI will read its prompt from top to bottom and the following blocks will indeed be "below".

🔗 Understanding the Flow

In our App, this means that the AI will:

Read the entire prompt from the paragraph block "DS. P. Summary"

See the instruction that the document to analyze is below

Access the content from the file block "DS. F. Document"

📁 Configuring the File Block

We're now going to configure the file block "DS. F. Document" so it receives the document uploaded by the user. To do this, we're going to associate it with the file attribute DS. Document that we created earlier.

Select File Block

In your block tree, click on your file block to select it, then click on the settings icon to the left of the "…".

A side panel will open with the block parameters.

Add File Attribute

Here, click the "Add an attribute" button under "File attribute" and select the "DS. Document" attribute.

This will allow the file block to extract the content from the document uploaded by the user and make it available to the AI.

🎯 Configuration Summary

What we've accomplished: We just configured an AI block with nested blocks, giving it an instruction prompt via the paragraph block DS. P. Summary and associating the file attribute DS. Document to the file block DS. F. Document.

✅ Ready for Next Step: We now need to link these blocks to the wizard so our AI agent can function.

Coming Next: Now, let's take care of the wizard.

3️⃣ Hands-on Practice - The AI Block

🧠 How the AI Block Works#

🤖 Understanding Generative AI#

📝 Understanding Prompts#

🔄 How This Works in Thinkeo#

⚙️ AI Block Configuration#

✍️ Writing the Instructions#

🔗 Understanding the Flow#

📁 Configuring the File Block#

🎯 Configuration Summary#

🧠 How the AI Block Works

🤖 Understanding Generative AI

📝 Understanding Prompts

🔄 How This Works in Thinkeo

⚙️ AI Block Configuration

✍️ Writing the Instructions

🔗 Understanding the Flow

📁 Configuring the File Block

🎯 Configuration Summary