# Create and Manage Agent This guide will walk you through the process of creating a new agent in our system. If you prefer watching a video : {% embed url="" %} ### Step 1: Navigate to the Agents Page Begin by accessing the Agents page in your dashboard.
### Step 2: Agent Creation Click on the "Create Agent" button. You'll be presented with the first phase of Agent creation:
#### Identity creation: * **Select and icon**
* **Name**: Choose a compelling name to define your Agent * **Description**: Write a little description in one sentence that will appear in your Agent's card and tht will help you remember his role. * **AI Model**: Each model comes with a brief description of its capabilities to help you make the right choice for your task.
* **Mood of the Agent:** The mood will guide your agent's in the way it will respond to your requests, from serious tone to very free and creative. * **Tags**: You can choose one or multiple tags in order to classify your agent in the agents page. #### Mission page: * On the mission page, you will write the prompt of your agent, which will be used to give it indications on how to behave, respond and other considerations you want to assign it.
* Should you struggle to write something that expresses what you want in detail, you can choose to write a simple sentence, and hit the "Enhance prompt 🪄" button to let us help you write something more special Then we have added a tool to keep your prompts structured. Press **`+ Add Section`** button to have scroll down menu that allows to put all necessary sections in a prompt. ![](https://2442470273-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBGWv9tHN4FLRiQu7ou5P%2Fuploads%2Fy9XjZgRmaeHMOA6dw8ZP%2FScreenshot%202025-01-06%20at%203.38.23%E2%80%AFPM.png?alt=media\&token=41a418de-228c-4ad7-a2ff-4a17cdb3ffbd) Then we offer you the possibility to test this set up directly on the right of the Mission Page :
#### Knowledge page: On the knowledge page, you will be able to add files from: * Your local machine, * The files you imported in your knowledge base, * Your google drive (should you have completed the integration) * Your Notion (should you have completed the integration) * From any webpage (🆕) (if the page is public)
* Once you have chosen the files you wanted, just hit the "Create Agent" button and let the magic happen. * A little popup will signify you that the operation was successful.
### Step 3: Edit your Agent * Once an agent is created, you will have 3 little dots on the top right of each of your agents.
* Allowing you do either Edit or Delete your Agent.
* Should you want to edit your Agent, you will be greeted with the same kind of pages than during the initial creation phase. * On the first page, you will be able to change the icon, the name, the description and the model * On the second one, you will be able to change the prompt, * On the third one, you will be able to import new files or delete old ones from the knowledge base of your Agent.
* Should you add new files, don't forget to press the "Upload Files" button before hitting the "Update Agent".
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.calk-ai.com/agents/whats-calk-agent/create-and-manage-agent.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.