Core Concepts
Everything you need to know about how Telumin works. Learn about agents, runs, tools, and credits.
Agents
An Agent is an autonomous AI that runs in the background to accomplish a goal you define. Unlike chatbots that wait for you to ask questions, agents proactively work for you.
Manual
You trigger it. It runs once.
Scheduled
Runs on a schedule (daily, hourly)
Continuous
Always running at intervals
Agent States
Every agent has a status that tells you what it's doing:
| Status | What it means |
|---|---|
| Draft | Created but not deployed yet. You can still edit it. |
| Active | Running or waiting to run on schedule. Uses credits. |
| Paused | Stopped temporarily. No credits used. |
| Error | Something went wrong. Check the logs. |
Runs
A Run is one execution of an agent. Every time your agent does its job, it creates a run record with:
- Status (pending, running, completed, failed)
- How long it took
- Credits used
- Results and any errors
You can view all runs in the Executions page or on each agent's detail page.
Tools
Tools are capabilities you give to your agent. Each tool has a purpose and a credit cost:
| Tool | What it does | Credits |
|---|---|---|
| Web Search | Search the internet for information | 0.2 |
| Web Scraper | Extract data from web pages | 0.3 |
| Code Execution | Run Python code for calculations | 0.5 |
| Image Generation | Create images with AI | 2.0 |
Data Sources
Your files and information that agents can access. Upload documents, connect URLs, or link to services.
Credits
Pay-as-you-go units. Each agent run costs credits based on processing and tools used. Credits never expire.