# Build your first agent #### 🛠️ Build Your AI Agent — Step by Step With Calk AI, creating an AI Agent is fast, flexible, and designed to fit your exact needs. Whether you’re building an assistant for onboarding, sales support, or document summarization, here’s how to do it in three simple steps: *** #### Before that get to the Agent Creation Page ⇒
#### ① Define the Task (Prompting) This is where you teach your agent **what to do**. 🧠 **How it works**\ You write a clear instruction, also known as a *prompt*. This tells the agent its job. The more specific, the better. You can read our Class on how to prompt : [Here](https://calk-ai.notion.site/how-to-prompt-101?pvs=4) ! 🔹 Example:\ For an assistant that summarizes sales calls, your prompt might be:\ \&#xNAN;*"Summarize this conversation and highlight key objections, buying signals, and next steps."* 🧩 **Tips for writing a good prompt** * Be clear and direct. * Break tasks into steps. * Use bullet points and examples. * Try loading from our **Prompt Library** to get started fast. ✨ You can test the prompt live before continuing.
### 🧠 Need a hand to write your prompt? Calk gives you 3 quick tools to build great prompts, even if you're not a prompt expert: *** **Check out our range of tools designed to assist you effectively!**

1️⃣ Help Me

Type one line describing your goal.
Calk turns it into a full prompt structure instantly.
🪄 Magic for when you don’t know where to start.		magicwand.png

2️⃣ # Add Section

Insert smart building blocks like steps, tone, formatting, etc.
Helps you structure complex prompts in seconds.		#calk.png

3️⃣ $ Variables

Make your prompt reusable with variables like $company or $companydetails.
Perfect for scaling across teams or use cases.		$-calktools.png
*** #### ② Connect Knowledge & Tools This is where your agent gets **context and capabilities**. **🔗 Connect Integrations** We support two types of integrations: * **Knowledge Integrations**\ → *Notion* and *Google Drive*\ These fetch documentation, playbooks, notes, and structured files.
* **Information Integrations**\ → *Slack, Intercom, HubSpot, Brevo, Airtable, Web pages...*\ These provide up-to-date business context directly into the agent’s hands.
🧠 Agents with connected integrations = smarter, faster, more relevant. **📂 Upload Local Files** Want to train your agent on a few PDFs or internal memos? Just drag and drop.
**🌐 Add a Website** Need your agent to "read" a public page? Add any URL and let it ingest the content directly. **🛠️ Enable Tools** * **Web Search** — for live internet browsing * **Web Scraper** — for turning sites into internal knowledge * **Reasoning Engine** — for more logic-heavy tasks * **Data Tools** — for generating charts from insights A possible use case ⤵️ Spy on your competitors blog or website with a scraper! *** #### ③ Set Identity Now define **who your agent is**. 🧑‍💼 **Name & Icon**\ Make it easy to recognize and reuse! 🧠 **Model Choice**\ Choose from top LLMs: GPT-4o, Claude, Mistral, Cohere.\ Each has strengths — pick the best for your use case. 🎭 **Tone Slider** * `0` = Serious and direct * `1` = Creative and human-like\ It adapts your agent’s language to fit the brand voice or target audience. 🏷️ **Tag by Domain**\ Organize by team or function: Marketing, HR, Customer Care, Dev, etc.
*** {% hint style="info" %} #### 💡 The Power of Ultra-Specific Agents Don’t build one general-purpose agent. **Specialize.** * One agent = one task = better results * Shorter prompts, cleaner outputs * Easier to troubleshoot and iterate 🔁 **Use agents in sequence**\ Build workflows where agents feed each other: > Ask `@accountSummary` to scan your Hubspot and extract client insights.\ > Then tag `@coldemailer` to generate a hyper-personalized outreach with those insights from Hubspot. **This layered logic allows your team to mix domain expertise with automation, boosting precision and saving time.** **See below the logic behind an agent ⤵️** {% endhint %}
✨ See examples in the [Use Cases section](https://docs.calk-ai.com/use-case) — from Marketing to Onboarding.️ You have pre made Assistants on your Agent page here ⇒ [Calk's Agent Page](https://app.calk-ai.com/agents). You just have to click on one with made by : `Calk Team` and tailor them to your needs!