[Enterprise](/content/enterprise/index.html)
Products
[Pricing](/content/pricing/index.html) [Docs](https://docs.potpie.ai/) [Blog](/content/blog/index.html)
[5k+](https://github.com/potpie-ai/potpie)
[Sign UP](https://app.potpie.ai/)
\\
\\
Specialists](/content/potpie-specialists/index.html) \\
\\
Forge](/content/potpie-forge/index.html) \\
\\
Recipes](/content/potpie-recipe/index.html) \\
\\
Trace](/content/potpie-trace/index.html)
Open-source custom AI agents
Aditi Kothari
Mar 20, 2025
[TL/DR;](/content/blog/open-source-custom-ai-agents#header-0/index.html) [Working of Custom AI Agents](/content/blog/open-source-custom-ai-agents#header-1/index.html) [Creating Custom AI Agents](/content/blog/open-source-custom-ai-agents#header-2/index.html) [Creating Custom Agent using Potpie API](/content/blog/open-source-custom-ai-agents#header-3/index.html) [Interacting with Your Custom AI Agent](/content/blog/open-source-custom-ai-agents#header-4/index.html) [Why It Matters](/content/blog/open-source-custom-ai-agents#header-5/index.html)
### TL/DR;
PotpieAI has launched Open-Source Custom AI Agents, enabling developers to build AI assistants that deeply understand their codebases. These agents leverage a Neo4j-based knowledge graph and CrewAI-powered RAG agents for intelligent, context-aware automation. Developers can create and manage agents via the Potpie dashboard or API, optimizing workflows with customizable AI assistance.
[Check out the release here](https://github.com/potpie-ai/potpie/releases/tag/v0.1.0)
Building AI agents that truly understand your codebase has always been our main goal at Potpie. We believe AI should seamlessly integrate into your development workflow, automating tedious tasks and enhancing productivity without compromising flexibility.
AI agents are transforming the way developers automate tasks, analyze codebases, and enhance productivity. Instead of relying on generic LLM models, these agents can be tailored to specific workflows, making them more efficient, context-aware, and capable of handling complex engineering challenges.
Following this, we’re thrilled to announce Potpie’s Open-Source Custom AI Agents. This means you can dive into the code, tweak it to your needs, and contribute to making AI-powered development even better. Whether you’re automating code reviews, debugging sessions, or developing new features, developers get to utilize the full potential of custom AI Agents.
### Working of Custom AI Agents
Potpie's Custom AI Agents are designed to analyze, adapt to, and enhance complex codebases just like an experienced developer. By leveraging in-depth code analysis, adaptive AI strategies, and context-aware enhancements, these agents go beyond basic linting tools to provide intelligent, and actionable fixes.
At the core of Potpie’s approach is a Neo4j-based knowledge graph that systematically maps out the entire codebase. This graph is constructed through a multi-stage processing pipeline, tracking:
- Component relationships (how different components interact and depend on each other)
- Function calls and data flow (to understand how state and logic are handled)
- Directory organization and purpose (enhanced with AI-generated docstrings for clarity)
This structured representation allows the AI agent to trace through the flow of the code and emulate a human developer's thought process, ensuring a deep contextual understanding of the project.
When a query is received, Potpie determines the best way to handle it through query classification. This Agent Supervisor is based on langgraph. If the AI model can answer using built-in knowledge and chat history, it responds immediately; otherwise, the query is sent to the RAG Agent for deeper analysis.
To ensure project-specific solutions, Potpie dynamically uses a specialized RAG Agent built using CrewAI. This agent plays a crucial role in querying the knowledge graph and refining the retrieved information.
Each created Agent consists of three basic parameters:
- **Role** – Defines the agent’s identity and primary function. It determines the agent’s expertise, such as a “Frontend Responsiveness Analyzer” responsible for retrieving and refining information from the codebase.
- **Goal** – Specifies the agent’s objective, outlining what it aims to achieve. For example, an agent’s goal could be to analyze frontend code, detect responsiveness issues, and suggest tailored fixes.
- **Task Structure** – Breaks down the specific steps the agent follows to accomplish its goal. This includes actions like query analysis, efficient context retrieval, result enrichment, and citation tracking, ensuring accurate and actionable insights.
To navigate and query the knowledge graph, the agent utilizes LangChain-based tools specifically designed for extracting structured information efficiently. Rather than just identifying problems, Potpie’s AI agents generate concrete and actionable output.
### Creating Custom AI Agents
The traditional method of building custom AI Agents involves specifying three parameters -
- **System Input** – Defining the input data the AI Agent should consider.
- **Task Description** – Specifying what the task Agent has to perform
- **Expected Output** – Outlining the format and structure of the Agent’s response
These three parameters work as the foundation of your AI agent, ensuring they are well-defined will significantly improve its performance.
At Potpie, we’ve reimagined how custom AI agents are built, making the process more intuitive and developer-friendly.
We’ve eliminated the hassle by allowing you to define everything in a single, detailed prompt. Simply describe:
- What your AI agent should do
- The process it should follow
- The expected output
Potpie intelligently analyzes your prompt and automatically generates a tailored configuration for your AI agent optimizing it for the specific task you want it to perform. It eliminates uncertainty and ensures your AI agent is precisely tuned to deliver accurate and efficient results right from the start.
To build custom AI Agent:
1. Login to Potpie dashboard using GitHub credentials - app.potpie.ai
2. Select the Custom Agents on left sidebar and click on “Create New Agent”
3. Enter a detailed prompt to create a custom AI agent, specifying its task, process, and expected output. The more detailed, the better.
4. Potpie analyzes the provided prompt and generates System Configuration, Agent Identity, and Tasks for your AI Agent. Simultaneously, giving you the flexibility to manually modify these generated prompts.
5. Once these configurations are finalized, your custom AI Agent is successfully created.
Checkout [docs](https://docs.potpie.ai/custom-agents/introduction) to learn more about custom AI Agents.
### Creating Custom Agent using Potpie API
If you want to build custom AI agents using the API, we’ve got you covered! With the API, you get the flexibility to create and run custom AI agents tailored to your project’s unique requirements on the cloud or locally, on your own machine if you’re evaluationg the open source version!
The Potpie API lets you do much more than just create custom agents. You can:
\- Start and manage conversations
\- Send and receive messages
\- Update or delete custom agents
… and so much more!
To set up the Potpie server locally. Follow the steps in our [documentation](https://docs.potpie.ai/open-source/setup) to get it up and running on your device.
After successfully setting up the Potpie server locally, you can run following command to create custom AI Agent:
curl-X POST "http://localhost:8001/api/v1/custom-agents/agents/auto" \
-H"Content-Type: application/json" \
-d'{
"prompt": "prompt\_text"
}'
Replace prompt\_text with your desired prompt. As discussed earlier in this blog, keep the prompt brief and descriptive to ensure optimal results.
If the request is successful, you’ll receive a response like this:
{
"role": "",
"goal": "",
"backstory": "",
"system\_prompt": "",
"id": "",
"user\_id": "",
"tasks": \[\
\
{\
\
"description": "",\
\
"tools": \[\
\
""\
\
\],\
\
"expected\_output": "",\
\
"id": 123\
\
}\
\
\],
"deployment\_url": "",
"created\_at": "2023-11-07T05:31:56Z",
"updated\_at": "2023-11-07T05:31:56Z",
"deployment\_status": ""
}
This response contains all the details of the generated Custom AI Agent.
### Interacting with Your Custom AI Agent
Once your custom AI agent is created, you can use it to interact with your codebase and perform various operations. To do this, Potpie provides a **"Create Conversation and Message"** API endpoint, allowing you to send a prompt to your AI agent and receive a response.
The endpoint is:
http://localhost:8001/api/v2/project/{project\_id}/message
You can integrate this into your backend API as follows:
app.post("/create-conversation", async (req, res) => {
try {
const response = await axios.post(
\`https://production-api.potpie.ai/api/v2/project/{project\_id}/message\`,
{
body: {
agent\_id: "agent\_id",
content:
“prompt\_text",
},
},
{
body: {
"x-api-key": "api\_key”
"Content-Type": "application/json",
},
}
);
- Replace {project\_id}, agent\_id, prompt\_text, and api\_key with your variables respectively
- To generate your API key, follow the [documentation](https://docs.potpie.ai/agents/api-access).
- The response will contain a text message based on the prompt you provided.
With this setup, your custom AI agent can now process queries and assist you in interacting with your codebase efficiently.
### Why It Matters
With Potpie’s Custom AI Agents, developers get more than just automated linting, they get a developer-level AI assistant that understands their code, improves efficiency, and provides transparent, customizable solutions. With introducing Open-Source Custom AI Agents, Potpie enables developers to extend, refine, and contribute to the future of AI-driven code analysis.
Checkout our Quickstart guide and start building with Potpie: [https://docs.potpie.ai/quickstart](https://docs.potpie.ai/quickstart)
Got stuck anywhere? Join our Discord Server - https://discord.gg/NxUQCcz6
" height="176.48689063250688px" id="t2zO9Quc7" stroke-dasharray="" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.55" stroke="rgb(180, 209, 63)" transform="translate(0.773 0.758)" width="307.0499654602649px"/>)
" height="127.83155915492955px" id="F7uNl9dyd" stroke-dasharray="" stroke-linecap="round" stroke-linejoin="round" stroke-width="2.46" stroke="rgb(180, 209, 63)" transform="translate(8.021 100.549)" width="136.10429429577454px"/>)
" height="275.2348071827544px" id="tOCVqXAMo" stroke-dasharray="" stroke-linecap="round" stroke-linejoin="round" stroke-width="2.05" stroke="rgb(180, 209, 63)" transform="translate(2.023 1.876)" width="306.08189403973506px"/>)
" height="272.22086421478906px" id="PPsuL8gM9" stroke-dasharray="" stroke-linecap="round" stroke-linejoin="round" stroke-width="2.04" stroke="rgb(180, 209, 63)" transform="translate(2.016 1.798)" width="306.4324539473682px"/>)
" height="176.48689063250686px" id="YZ_qP17EP" stroke-dasharray="" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.55" stroke="rgb(180, 209, 63)" transform="translate(0.773 0.758)" width="307.04996546026496px"/>)
" height="150.90560294117645px" id="jxii70vzV" stroke-dasharray="" stroke-linecap="butt" stroke-linejoin="miter" stroke-miterlimit="10" stroke-width="5.69" stroke="rgb(180, 209, 63)" transform="translate(24.37 4.791)" width="261.37546588235216px"/>)
" width="309px">)
" width="291.547144895145px">)
" width="279.949712674067px">)
[Try Potpie →](https://app.potpie.ai/) [Book a demo](https://cal.com/team/potpie/potpie-s-product-demo)
Recommended Blogs
\\
\\
Evals\\
\\
Evaluating AI Coding Agents in the Real World\\
\\
\\
\\
Kshitij Mishra\\
\\
Apr 9, 2026](/content/blog/evaluating-ai-coding-agents-in-the-real-world/index.html)
\\
\\
compliance\\
\\
Compliance Is Architecture: Why Your AI Agent Needs a Context Graph\\
\\
\\
\\
Yash Krishnan\\
\\
Apr 9, 2026](/content/blog/compliance-is-architecture-why-your-ai-agent-needs-a-context-graph/index.html)
\\
\\
Complaince\\
\\
Compliance as Architecture: Building Trustworthy AI from the Ground Up\\
\\
\\
\\
Yash Krishan\\
\\
Feb 2, 2026](/content/blog/compliance-as-architecture-building-trustworthy-ai-from-the-ground-up/index.html)
\\
\\
Product\\
\\
How Customer Onboarding Works at Potpie\\
\\
\\
\\
Kshitij Mishra\\
\\
Mar 18, 2026](/content/blog/how-onboarding-works-at-potpie/index.html)
\\
\\
Knowledge Graph\\
\\
Building a Distributed Knowledge Graph Pipeline\\
\\
\\
\\
Dhiren Mathur\\
\\
Mar 16, 2026](/content/blog/building-a-distributed-knowledge-graph-pipeline/index.html)
\\
\\
Evals\\
\\
Repository Intelligence: Building the Next Generation of Agent Evaluation Data\\
\\
\\
\\
Deeptendu\\
\\
Feb 27, 2026](/content/blog/the-agent-evaluation-gap/index.html)
\\
\\
Agents\\
\\
AI Memory is Broken: we need brains, not hard drives\\
\\
\\
\\
Deepesh Genani\\
\\
Feb 4, 2026](/content/blog/ai-memory-is-broken-we-need-brains-not-hard-drives/index.html)
\\
\\
Behind the scenes : Potpie SWE Bench Agent \\
\\
\\
\\
Nandan\\
\\
Jan 29, 2026](/content/blog/behind-the-scenes-potpie-swe-bench-agent/index.html)
\\
\\
Engineering Agents\\
\\
Agentic COSS 2025\\
\\
\\
\\
Aditi Kothari\\
\\
Mar 20, 2025](/content/blog/agentic-coss-2025/index.html)
\\
\\
LLMs\\
\\
Potpie supports Multi-LLMs\\
\\
\\
\\
Dhiren Mathur\\
\\
Feb 27, 2025](/content/blog/potpie-supports-multi-llms/index.html)
\\
\\
Product\\
\\
Release of New web access feature\\
\\
\\
\\
Ayush Thakur\\
\\
Feb 20, 2025](/content/blog/release-of-new-web-access-feature/index.html)
\\
\\
Product\\
\\
Deconstructing Potpie’s Debugging agent\\
\\
\\
\\
Dhiren Mathur\\
\\
Nov 15, 2025](/content/blog/deconstructing-potpie%E2%80%99s-debugging-agent/index.html)
\\
\\
Open Source\\
\\
Leveraging Codebase Knowledge Graphs for Agentic Code Generation\\
\\
\\
\\
Dhiren Mathur\\
\\
Oct 15, 2025](/content/blog/leveraging-codebase-knowledge-graphs-for-agentic-code-generation/index.html)
Spec driven development for large scale engineering
Product
[Enterprise](/content/enterprise/index.html)
[Use-cases](/#product)
[Blog](/content/blog/index.html)
[Pricing](/#home-pricing)
[Potpie for VS Code](https://marketplace.visualstudio.com/items?itemName=PotpieAI.potpie-vscode-extension)
[Documentation](https://docs.potpie.ai/introduction)
Company
[Trust Center](https://trust.potpie.ai/)
[Press](https://www.forbes.com/sites/davidprosser/2026/02/23/how-poptie-plans-to-help-enterprises-smash-the-ai-agent-barrier/)
[Careers](https://wellfound.com/company/potpie-ai/jobs)
[Open Source](https://github.com/potpie-ai/potpie)
[Contact Us](/content/contact/index.html)
Legal
[Privacy Policy](/content/legal/privacy-policy/index.html)
[Terms](/content/legal/terms-of-service/index.html)
© 2026 Potpie. All rights reserved.
\[CODEBASE Q&A AGENT\]