Key facts
| API surface | OpenAI-compatible /v1/chat/completions; change base_url and model name |
| Models | 30+ models including long-context and multilingual options |
| Retrieval | Embeddings and RAG are live for software engineering document search with citations |
| Agents | Function calling and agent orchestration are live |
| Deployment | Plugsky cloud, your VPC, on-prem or air-gapped |
| Data residency | Region selection and sovereign deployment options |
| Free tier | Free plan with 2 free AI models (plugsky-micro, plugsky-lite), no card |
| Endpoint roadmap | Audio, images, moderation, batch and fine-tuning are coming soon |
TL;DR
- Put design docs, postmortems and API references behind a cited RAG assistant.
- Deploy in your VPC, on-prem or air-gapped so design and incident data stays inside your boundary.
- Embeddings and RAG are live today; audio and image endpoints are on the roadmap.
- Function calling lets agents read issue and observability systems on request.
- Evaluate on the free plan, then move to a private deployment for production.
How it works, step by step
- Inventory document sources: design documents, code review notes, incident postmortems, API references and architecture decision records.
- Classify content by sensitivity and decide what may leave an on-prem or air-gapped boundary.
- Create a Plugsky account and API key on the free plan, or request a private deployment.
- Chunk and embed approved documents, keeping the vector store inside your own environment if required.
- Wire retrieval into an assistant that cites sources and refuses out-of-scope questions.
- Add function calling for issue and observability systems once retrieval is trusted.
- Log queries and answers, review them weekly, and expand coverage document class by document class.
Original data
Try it yourself
Open the RAG architecture builder →
Where software engineering teams get value first
Start with document-heavy work that already has an owner and an approval path:
- Engineering knowledge search: answer architecture and design questions with links to the source docs.
- Incident response: pull past postmortems and runbooks for the system that is failing.
- Onboarding: compress ramp-up time with cited answers about the codebase and processes.
- Team knowledge: keep decisions searchable after the authors move on.
Each use case is retrieval-first: the model answers from your documents and shows where the answer came from.
Architecture: retrieval first, agents second
A workable stack is small: an ingestion pipeline that chunks and embeds approved documents, a vector store you control, and a chat call that receives the top matches as context. Plugsky embeddings and chat completions are OpenAI-compatible, so the glue code is familiar to any team that has used the OpenAI SDK.
Add function calling only after retrieval is trustworthy. Agents can then request data from issue trackers, CI/CD and observability systems through your own APIs, with the model choosing the call and your service enforcing permissions.
Residency, access and auditability
Software engineering data is sensitive. Plugsky supports cloud, VPC, on-prem and air-gapped deployments, with region selection for residency requirements. Air-gapped installations keep prompts and documents inside your network entirely.
Use scoped API keys per application, rotate them on a schedule, and log requests and responses under your retention policy. Keep source-adjacent secrets out of indexes and prompts, and scope access by repository or team.
A rollout plan that stays explainable
Pick one document class, build a fifty-question evaluation set with known answers, and measure retrieval hit rate and answer accuracy before expanding. Publish the assistant to one team, collect the questions it could not answer, and close those gaps by adding documents rather than prompts. Redact secrets during ingestion and scope access by repository or team before broad rollout. Keep every answer traceable to a source.
Honest comparison
| Capability | Plugsky | Generic chatbot | Building in-house |
|---|---|---|---|
| Software engineering document search | RAG with citations over your corpus | No access to internal documents | You build ingestion and evaluation |
| Deployment | Cloud, VPC, on-prem, air-gapped | Vendor cloud only | Your infrastructure |
| Model choice | 30+ models behind one API | Single vendor model | You host each model |
| Function calling | Live for issue and observability systems | Limited or unavailable | Custom integration work |
| Pricing | Flat monthly self-serve plans; see live pricing | Per-seat subscription | GPU plus operations cost |
| Audio and image endpoints | Coming soon | Varies by vendor | Separate pipelines to maintain |
Frequently asked questions
Can our data stay inside our own network?
Yes. Plugsky supports VPC, on-prem and air-gapped deployments, so prompts, documents and embeddings remain inside your environment when required.
Does Plugsky train on our documents?
For strict requirements, choose a private or air-gapped deployment so content stays inside your environment. Review the current data-handling terms and DPA for cloud plans before rollout.
How do citations work?
Your retrieval layer passes the top matching chunks into the chat call, and the assistant returns answers with references to those chunks. Require a refusal when no source clears the relevance threshold.
Which model should we use for design docs and incident postmortems?
Benchmark a long-context model against chunked RAG on your own questions. Long-context helps with whole-document reasoning; RAG is cheaper and easier to cite.
Is there a free way to evaluate this?
Yes. The free plan includes two free AI models with no card, and the 14-day full-access trial lets you test larger models on your documents.
How do we keep secrets out of the index?
Redact credentials and secrets during ingestion, index only documentation and knowledge sources, and scan the corpus on a schedule.
Can it index code comments and design docs?
Docs, markdown and text-based sources are straightforward today; dedicated vision endpoints for architecture diagrams are coming soon.