Built-in and Custom Agents

overview agents let you define ai agents tailored to your workflows and connect them to external tools via mcp servers such as github, azure devops and more the custom agents appear alongside built‑in agents on the agents page so your teams can use them across clusters built in agents navigate to agents in the left sidebar > https //app kubegrade com/agents https //app kubegrade com/agents select an agent in the built in agents section to customize them fill out the custom instructions field if you want to further customize the agent example assistant agent accessing custom agents navigate to agents in the left sidebar > https //app kubegrade com/agents https //app kubegrade com/agents use the create agent field to start a new custom agent or select an existing one to edit > https //app kubegrade com/agents/create https //app kubegrade com/agents/create built‑in agents can be customised (prompt and mcp configuration) without affecting future kubegrade updates to the base product agent configuration each custom agent has three main configuration areas overview agent name human‑readable name shown to users in the agents list description short explanation of what this agent does and when to use it instructions (agent prompt) the agent prompt defines the default behaviour and tone of the agent click build prompt to open the prompt builder enter a high‑level description of what the agent should do click on the button with the arrows to generate a suggested prompt you can edit the prompt text directly at any time click insert to insert the suggested prompt in the agent prompt field as instructions for the agent mcp servers mcp servers connect the agent to external systems (for example github, azure devops and more) an agent can have zero, one, or multiple mcp servers enabled given they are complementary (e g only one gitops connection at a time) mcp settings apply only to the selected agent and do not affect other agents working with mcp servers custom agent mcp servers go to https //app kubegrade com/agents https //app kubegrade com/agents to customise built‑in agents or create, edit, and delete custom agents when creating or editing a custom agent, you can connect mcp servers adding an mcp server in the agent editor, scroll to the mcp servers section click + connect mcp servers in the connect mcp server dialog, choose an mcp server type from the dropdown (for example github or azure devops ) configure authentication for the selected server by entering the requested information and clicking connect select which tools from that mcp server should be available to this agent click save to persist the configuration example github mcp server when you choose github as the mcp server enter a personal access token (pat) with the scopes needed for the tools you plan to use (for example repository read or read/write for pr workflows) click connect so kubegrade can validate the token and load the available tools under tools , choose one or more tools (for example git repository access or pr helpers) that the agent will be allowed to call save the agent to make the github integration active publishing and managing agents draft vs published new agents start as drafts and are only visible in the editor click publish to make the agent available to users in the agents view and dropdown selection in the agent chats editing and versioning you can update the name, description, prompt, or mcp servers of an existing agent at any time changes to a published agent take effect immediately for all future conversations that use that agent deleting agents from the agents list, open the menu for an agent and choose delete to remove it deletion does not affect any github or azure devops resources; it only removes the configuration inside kubegrade