Starbase / 01 PlainAgent

PlainAgent / How to build an AI agent, step by step

Core guide · 7 steps

How to build an AI agent, step by step

An AI agent is a language model that can take actions to finish a job, not just answer a question. Building a useful one is mostly about decisions, not code. This guide walks through the seven decisions in order. You can do every step with a no-code tool.

Short version: pick one small job, write down exactly what goes in and what comes out, give the agent only the tools that job needs, write rules for when to stop and ask a person, then test it on real examples before you let it act on its own.

1. Pick one job, not a "do everything" assistant

Most first agents fail because the job is vague. "Help with customer emails" is vague. "Label each new support email as billing, bug or how-to, and draft a reply for how-to questions" is a job. A good first job is something you already do by hand, at least a few times a week, with a clear right answer.

Write it in one sentence: When X happens, the agent does Y and the result goes to Z.

2. Decide the trigger

What starts the agent? The common options are: a person sends a message (a chatbot), a new item arrives (an email, a form submission, a file), or a schedule (every morning, every Friday). The trigger decides which tool you build in. Chat triggers suit chatbot builders; event and schedule triggers suit automation tools such as n8n, Zapier or Make.

3. List the inputs and the knowledge it needs

Write down exactly what information the agent sees each time: the email body, the form fields, the order record. Then list the background knowledge it needs: policies, product facts, a help center. If a person doing this job would need to look something up, the agent needs that too, either pasted into its instructions or connected as a knowledge source.

4. Give it tools, and as few as possible

Tools are the actions an agent can take: search a document, look up an order, create a draft, add a row, send a message. Each tool is a way for things to go wrong, so start with read-only tools and drafts. Let the agent draft an email before you ever let it send one.

5. Write the rules and the handoff

Rules are the things it must never do and the moments it must stop. Write them plainly: "Never promise a refund outside the policy." "If the order number is missing, hand off to a person." Every agent should have a clear handoff path to a human, and a clear definition of "done".

6. Write the system prompt

The system prompt turns the decisions above into instructions. A reliable structure is: role, job, inputs, rules, output format, and handoff. Ask for structured output (like JSON) whenever another step will read the result. See how to write an agent system prompt, or use the free agent planner to generate one from your answers.

7. Test on real examples, then launch with a person in the loop

Collect 20 to 30 real examples, including awkward ones: missing data, angry messages, questions it shouldn't answer. Run them all and read every result. Then launch with a person approving actions, and only remove that approval for the parts that have been right consistently. Keep reading logs after launch; agents drift when inputs change.

Which tool should you build in?

For a chatbot that answers from documents, a chatbot builder (Custom GPTs, Claude Projects, Microsoft Copilot Studio, Voiceflow, Botpress) is usually fastest. For an agent that reacts to emails, forms or schedules and acts in other apps, an automation tool (n8n, Zapier, Make) fits better. If you write code, agent frameworks such as the OpenAI Agents SDK or LangGraph give you full control. See tools for building AI agents.

Want a ready-made workflow instead?

This site explains the decisions. If you'd rather import a finished n8n or Zapier workflow, our sister site RecipeAgents has ready-made recipes, and a more technical n8n build walkthrough.

Next steps

Sponsor slot · availableFeature your product here
Newsletter

One agent template a week

A short Friday email: one agent spec, the system prompt, and what to test before you switch it on. Free, and the unsubscribe link is in every email.