> For the complete documentation index, see [llms.txt](https://gopersonal.gitbook.io/calvin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gopersonal.gitbook.io/calvin/user-guides/agents.md). # Agents Agents are the AI copilots that power Calvin. Each agent is specialized in a particular role, belongs to a team, and has an assigned seniority level that reflects its depth of expertise. The Agents page shows your full squad — both Calvin's built-in agents and any custom agents you have created. Calvin ships with nine built-in agents organized across three teams. The Core Development Team includes the Full Stack Developer (Senior), who executes technical changes, fixes, and builds components across the full stack; the Analyst (Mid), who analyzes data, generates insights, and produces reports; the VTEX IO Developer for Theme (Mid), specialized in building and maintaining VTEX IO storefronts; the Magento Developer (Senior), focused on Magento eCommerce development; the Ruby on Rails Developer (Senior), for building and maintaining systems in Ruby on Rails; the Web QA Specialist (Junior), who detects errors, runs validations, and ensures quality before publishing; and the n8n Workflow Developer (Senior), for building automation workflows with n8n. The Creative Team includes the UI/UX Specialist (Senior), who resolves design tasks and UI adjustments without blocking the rest of the team. The Analytics Team includes the Data Scientist (Senior), who builds ML models and analytics pipelines for eCommerce insights. Seniority levels reflect the agent's depth of knowledge and autonomy. Senior agents have the broadest knowledge and can handle complex, ambiguous tasks with minimal guidance. Mid-level agents are strong in their domain but may need clearer instructions for edge cases. Junior agents are effective for well-defined, repeatable tasks and are great for high-volume QA and validation work. When you create a workspace from a template, Calvin automatically assigns the appropriate agents. For example, a Web Development workspace gets a Full Stack Developer and an Analyst, while a UI/UX Design workspace gets a UI/UX Specialist. Beyond the built-in agents, you can create Custom Agents tailored to your specific workflows. Click "+ Custom Agent" on the Agents page to open the creation dialog. The Info tab asks for an Agent Name, a Description (up to 512 characters explaining the agent's purpose), and a Mission and Goal (defining what the agent should accomplish). The Knowledge tab lets you upload files and instructions that help the agent perform better — for example, your brand guidelines, coding standards, API documentation, or product catalog specifications. Custom agents appear in the Custom Agents section on the Agents page, tagged as "Custom." You can assign them to workspaces alongside or instead of the built-in agents. This is powerful for creating agents that understand your specific business processes, like a "Variant Creator" that generates product variants following your catalog rules, or a "Code Reviewer" that checks pull requests against your team's standards. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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://gopersonal.gitbook.io/calvin/user-guides/agents.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.