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.