📚 Learning Flow

AI Agent Tutorial

Quick Start (3 minutes)

System Overview & Core Concepts

Run in Colab (No Code)

Build Your Own AI Agent

FAQ / Troubleshooting

Learn how the AI Agent works—without installing anything

In this chapter we’ll walk through the AI Agent’s end-to-end flow, using Google Colab so you don’t need to set up Python on your computer.

• The AI Agent is written in Python. Normally you’d install a Python interpreter, packages, and permissions.
• Colab skips all that: open it in your browser → connect to a cloud runtime → click the Play buttons in order.
• Result: no installation, no coding—perfect for class use and first-time learners.

Colab notebook

One-time setup: account & keys

1. Create an account at **https://one.araliadata.io/**.
2. Sign up / sign in to Stellar (Aralia’s developer console).
3. Get your API credentials (your secure “pass” that identifies you to the system):
   • Go to User Settings
   • Open For Developers
   • Click Generate Key → you’ll receive Client ID and Client Secret
4. Keep your Client ID & Client Secret safe. You’ll paste them into Colab and use them for any future development.

💡

What’s a “key”?

Think of it like a

library card

Client ID/Secret

Use the Colab notebook (point-and-click, no code)

1. Open the Notebook
2. Click Connect (top right/left) to “Connect to hosted runtime.” This spins up a cloud machine for you.
3. When prompted in the notebook, paste your Secrets / Keys:
   • LLM API Key (start with Gemini; you can switch to OpenAI/Anthropic later)
   • Client ID / Client Secret (from Stellar)
4. Click the ▶ Play icon on each cell in order:
   • Install & import
   • Initialize (OAuth sign-in, choose your Planet)
   • Ask your complete question (you can start with the Malaysia GDP × Gini example)
5. You’ll see:
   • a list of data sources the Agent selected
   • a short insight generated by the LLM (about ~300 words)

Stuck? Try this:

• Most issues are either keys not pasted correctly or the year/region doesn’t exist in the dataset—double-check both.

• Not sure about your keys? Go back to One-time setup and follow the steps to generate them again.

                                                ← Previous： [**Run in Colab (No Code)**](<https://deciduous-centipede-9d7.notion.site/Run-in-Colab-No-Code-269ddf94fd1481dda3d4ed06e450afcd>) 　|    Next：[
  

Build Your Own AI Agent](https://deciduous-centipede-9d7.notion.site/Build-Your-Own-AI-Agent-269ddf94fd1481b686fcc76c5d51d3aa) →