dusk bot
guideswhat is an ai agent

dusk botguides

what is an ai agent, in plain english?

an ai agent is a program that uses ai to work toward a goal through a series of actions. instead of only telling you how to do something, it can use tools, inspect what happened and choose a next step. you still need to give it a clear job, suitable access and a way to stop. calling it an agent does not make its decisions correct.

by the dusk bot team · checked · how we made this

pixel art: a pink pixel bot, a mint cat bot and a lime pixel bot beside a desktop computer and two chat bubbles, on a grassy meadow in front of white cliffs with a waterfall, one saying "what happens next?"

follow one small job from start to finish

imagine you want a reading list from a folder of documents. the job is to identify the documents, read them, group them by subject and produce an index. a useful result would point back to each source, rather than simply sound like a good summary.

the agent needs more than a sentence generator for that job. it needs a way to inspect the folder and read its contents. after reading, it might discover that a file is unrelated or cannot be opened. it should tell you about that gap instead of pretending every file was covered. the sequence of looking, acting and checking is what matters here.

how that differs from asking a chatbot

a chatbot can explain how to build the index or help write a summary from text you provide. an agent with suitable tools can carry out the steps in the workspace. the agent versus chatbot comparison is useful when choosing which sort of help you need.

the boundary is about what the program can do in the task, not whether its interface looks like a chat. you might text an agent, and a chat product might also offer tools. ask a concrete question: can it inspect the material and make the result where i need it, or am i doing those steps myself?

four parts to specify before it starts

  • the goal: a reading index, not a general request to organize your life.
  • the material: the exact folder or files it should inspect.
  • the boundary: leave originals alone; report anything it cannot read.
  • the result: a short index in the chat, grouped by subject, with source names.

those details let you judge completion. they also make a failure visible. if a source is missing from the index, you can ask why. if the brief only says "help me get organized", almost any response might look acceptable. start with a job whose result you can check in a few minutes.

where dusk bot fits this idea

dusk bot is a desktop app where you keep a small team of ai bots and text them like teammates. each bot has a name, a job, its own chats and memory, and the ai you choose. it runs the ai vendors' official command-line apps on the machine where your bots live.1

you can drop files into a chat or use Attach files. what bots make appears in the chat and lives in the bot's folder, or a project folder you give it. that makes a bounded file job a place to start without connecting a whole set of accounts. dusk bot has no model of its own; the ai you picked still does the thinking.2

access and repetition are separate decisions

an agent does not need every app you use. if it only needs files you give it, begin there. if it needs an external system, learn what a connector exposes. the mcp guide explains one standard used to connect ai apps to other systems.

repeating the job is another decision. in dusk bot, a routine is a job you describe once for a bot to repeat. on your computer it cannot run while the app is closed or the computer sleeps. scheduled ai tasks covers that timing question. do not confuse permission to do a task once with a reason to run it forever.3

what you should still check yourself

an agent can choose an unhelpful next step, misunderstand your goal or write a convincing summary of the wrong document. check the source material, especially dates, names and claims you plan to pass on. a successful first run is a reason to try another small job, not to give it unrestricted access.

before moving into accounts or computer control, read the safety guide. choose reading access where possible and keep consequential sends supervised. the useful measure is whether the result is correct and reviewable, rather than how many tools the agent used.

questions

what are people actually using ai agents for?

start with a task such as indexing documents you hand it, preparing a comparison from files you provide or repeating a narrow check. choose something whose inputs and finished result you can inspect yourself.

does an ai agent have to run all day?

no. it can do one job while you watch. recurring work needs a schedule and a computer or hosted environment that is running when the job is due.

is an ai agent the same as a bot?

bot is a broader everyday word. to understand what a particular bot can do, look at its tools, access and instructions rather than the name attached to it.

sources

  1. dusk bot docs: getting started and the ai
  2. dusk bot docs: files and apps
  3. dusk bot docs: routines

drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].