This tutorial covers the most basic yet essential process for newcomers to Agentria.

In this exercise, you will activate the Gmail node, connect your Google account, and build an Ability that sends an email.

Prerequisites

To begin, create a project in Agentria and open the Ability Editor Canvas.

For details on how to enter the canvas, see Step 1 (Create a Project and Select an Editor) in the 3-Step Core Guide.

By completing this tutorial, you will learn how to:

1. Add nodes

2. Declare variables in the Start Node

3. Connect nodes

4. Register Gmail credentials

5. Link your Google account

6. Configure credentials in the Gmail node

7. Set up email delivery in the Gmail node

8. Run the workflow and check the results with Run Test

Step 1: Create Google OAuth

To use the Gmail node, you must configure credentials based on authentication keys provided by Google.

Google access tokens can only be issued through the OAuth flow.

If this is your first time creating a Google OAuth credential, follow the Google Credential Guide.

Step 2: Register Gmail Credentials

Credentials are authentication details required for users to securely access a system or service.

For this tutorial, select the Google Gmail template when registering your credential.

Once your Gmail credentials are registered using the guide, proceed to Step 3.

Step 3: Add a Gmail Node

Click the +Add Node button at the bottom of the canvas. In the sidebar’s Tools category, drag and drop the Gmail node onto the canvas.

Hover over the node and click the Edit icon to open its options.

Rename the node to Send Gmail Node.

Since Gmail nodes can perform multiple operations (Send, Get, List, Delete), it’s best to name them according to their function.

Step 4: Declare Input Variables

Every Agentria canvas includes a Start Node and an End Node.

• The Start Node triggers the workflow.

• The End Node closes the workflow.

Double-click the Start Node to open the editor. Here, you can set data types, names, and descriptions.

For sending an email, declare three String variables:

• To

• Subject

• MessageBody

When finished, return to the editor canvas.

Step 5: Connect Nodes with Edges

To pass input variables from the Start Node to the Gmail Node, connect them with an edge.

Connect the Start Node’s right-side Out-Connector to the Gmail Node’s left-side In-Connector.

This delivers the input values to the Gmail node.

Step 6: Configure the Gmail Node

Double-click the Gmail Node to open the editor.

Select the Gmail credential you registered earlier.

In the Operation settings, choose how the node should use Gmail.

For this tutorial, select Send Message.

To send an email, use the variables declared in the Start Node (To, Subject, MessageBody).

Click Show Optional Variables and clik +Add Optional Variables, then select:

• to

• subject

• message_body

The Gmail node will output results in JSON format.

Step 7: Bind Variables with Drag and Drop

Agentria lets you connect variables without writing code.

Simply drag and drop to match variables:

• to : To

• subject : Subject

• message_body : MessageBody

Step 8: Run a Node Test

After configuration, click the TEST button in the Input section of the editor to check the Gmail Node.

Node Testing allows you to verify a single node before connecting it to others—helping minimize errors and keep the workflow stable.

Enter a recipient address, subject, and message body in the input fields, then run the test.

You’ll see the transmission details in the result output.

Check your Gmail Sent folder or the recipient’s inbox to confirm the email was delivered.

Step 9: Connect the End Node

Now pass the email result into the End Node.

On the canvas, connect the Gmail Node to the End Node.

Double-click the End Node, open the editor, and add a JSON variable named Mail.

Drag and drop the Gmail Node’s result into Mail.

Your ‘Send Gmail’ workflow is now complete.

Step 10: Run the Entire Workflow

Click the Run Test button at the bottom-right of the canvas to execute the full workflow.

Enter the recipient, subject, and message body, then run the test.

You’ll see the transmission details in the Mail result.

Check Gmail to confirm the message was successfully sent.

Next Steps

🎉 Congratulations! You’ve completed your third Agentria workflow: Send Gmail.

Now, try expanding it—add operational settings, define new variables, and explore advanced workflows.

Agentria is a space where ideas turn into reality.

With your imagination, workflows can expand infinitely.

For more beginner examples, see the Beginner Guide.