Tutorials

Each tutorial is a small, complete project that runs. Start at the top: every one adds one idea to the ones before it. All the code is in examples/, in TypeScript, Python and C#.

#	Tutorial	You’ll learn
1	Hello, agent	agents, interactions, deploying, running
2	Prompts and inputs	prompt files, inputs, optional text
3	Typed answers	JSON answers that match a schema
4	Runs	starting a run without waiting, its status, listing and cancelling runs
5	Watch it think	streaming the reply as it’s written
6	Routed agents	a router that hands each question to the right specialist
7	A chat	conversations with a person
8	Your first tool	letting an agent call an API
9	Call your code	tools on your own server, secrets
10	Approvals	a person approving a tool call before it happens
11	Know when it’s done	webhooks
12	Live events	following your runs live over one WebSocket
13	Your documents	knowledge bases (RAG)
14	Search the web	built-in web search and fetch
15	Files for agents	virtual file systems
16	Apps	apps that orchestrate agents
17	On a schedule	automations
18	Sub-interactions	agents that start other agents, in parallel
19	Managed teams	a manager that hands out work, and which team pattern to use
20	Memory	agents that remember people
21	Sandboxes	running code in a capsule
22	Code pipelines	AI coding agents on your git repo
23	Support desk	all of it together in a support console you can deploy
24	Your customers’ keys	credentials and credential stacks: each customer on its own key

Before you start

Finish Get started first. You need:

an API key, in the MAITENTO_API_KEY environment variable;
a namespace for the tutorials, in MAITENTO_NAMESPACE. We use tutorials;
a DeepSeek model key, because the tutorial agents use DeepSeek’s deepseek-v4-flash. To use another provider, change model in each agent file to a model you have a key for.

Each tutorial’s code deploys its own project, so you can run them in any order once you’ve done the first. Two build on the one before: tutorial 10 uses tutorial 9’s orders API and secret, and tutorial 17 schedules tutorial 16’s app.

Running the code

# Node.js 22.18 or later runs TypeScript directly.
cd examples/01-hello-agent/typescript
npm install
node hello.ts

# Python 3.10 or later.
cd examples/01-hello-agent/python
pip install -r requirements.txt
python hello.py

# The .NET 10 SDK runs a single .cs file directly.
cd examples/01-hello-agent/csharp
dotnet run hello.cs

# The mt command line (needs .NET 8 or later).
dotnet tool install --global Maitento.Shell
cd examples/01-hello-agent
mt deploy ./maitento
mt interaction-run hello