1. Create an Agent¶
What is an "agent," really?¶
An agent is an AI assistant that you build and configure.
Think of it like hiring a new employee:
- You give it a name (so you can find it later).
- You give it instructions (so it knows how to behave).
- You decide what it's allowed to do.
The platform handles all the hard technical work behind the scenes. You just fill in a short form.
Before you start¶
Make sure you're logged into the AI Foundation Management UI. If you don't have access yet, see the Prerequisites checklist on the index page.
Steps¶
Follow these steps in order:
-
Open the Agents home page. This is the root page (
/) of the AI Foundation Management UI. It lists every agent that already exists on the platform. -
Click the "+ Create Agent" button. This opens the form for building a new agent.
-
You'll land on the "Basics" tab. Don't worry about the other tabs you see (Integrations, Skills, Memory, SOPs, Advanced) — you don't need any of those yet. We'll cover some of them in later steps.
-
Fill in the three fields on the Basics tab:
- Name — a short, memorable label for your agent.
- Example:
hello-world-agent -
Why it matters: This is how you'll find your agent later in the agent list.
-
System prompt / instructions — plain-language instructions telling the agent how to behave.
- Example: "You are a friendly assistant. Be concise."
-
Why it matters: This is the agent's "personality" and rulebook. The AI reads this every time it responds to you.
-
Agent type — choose Simple agent.
- Why it matters: A Simple agent works entirely on its own — perfect for this guide.
- The other option, Orchestrator, is a "manager" agent that delegates work to a team of other agents. Ignore it for now — you can explore it later once you're comfortable with the basics.
-
Click "Submit" (or "Save"). This creates your agent.
✅ Checkpoint: What you just did¶
Congratulations — you just created your first AI agent! 🎉
Here's what happened:
- Your new agent now shows up in the agent list on the home page.
- It has a status of "created."
- It doesn't have any tools yet — that's normal, and it's what we'll fix next.
- It hasn't been deployed anywhere yet either — also normal, and also coming up.
You don't need to understand everything about your agent yet. Right now, it exists — and that's a big first step.
Next¶
Ready for more? Head to 2. Register a Tool (MCP Server) to give your agent its first real skill.