microsoft / microsoft/simplechat
Public Workspace for Documentation in Simple Chat
- Dominant language
- Python
- Stars
- 152
- Forks
- 116
- Avg merge
- 7h 7m
- Merged PRs (30d)
- 122
Description
Add the ability to include documentation as a **Public Workspace** in Simple Chat so that it is automatically loaded into AI Search. This would allow users to directly ask questions about the documentation from within Simple Chat, instead of navigating externally.
---
## Motivation
* Many users will want quick answers from documentation without leaving Simple Chat.
* Embedding documentation in a Public Workspace makes it discoverable in AI Search, improving usability and knowledge access.
* This also opens the door to using the **default agent** as a gateway to documentation APIs or linked resources.
---
## Proposal
1. **Public Workspace for Docs**
* Enable admins to publish official documentation into a Public Workspace.
* Documentation would be chunked, indexed, and searchable by AI Search.
2. **Optional Admin Setting**
* Provide a toggle in Admin Settings to enable or disable this feature.
* If enabled, the documentation workspace becomes searchable across all users.
3. **Default Agent Integration (Optional)**
* Allow an admin to link the documentation workspace to the default agent.
* This could let users query documentation naturally, either via embedded context or via API calls to docs.
---
## Alternatives Considered
* **External Documentation Site Only**
* Current state: documentation exists but is not searchable within Simple Chat.
* Downside: users must switch contexts, slowing workflow.
* **Dedicated Documentation Agent**
* An agent solely for docs, instead of a workspace.
* Could be useful, but adds extra navigation overhead.
---
## Benefits
* Centralizes knowledge inside Simple Chat.
* Reduces friction for new users learning features.
* Provides a better self-service support experience.
* Aligns with how customers expect modern copilots to surface knowledge.
---
## Next Steps
* Define whether documentation should be **always included** in Public Workspaces or **admin-enabled**.
* Explore whether this should tie directly to the default agent or remain a standalone workspace.
* Consider linking to external APIs (docs, changelogs, support articles) to keep the workspace current.
---
Would you like me to also create a **checklist/acceptance criteria section** (like “When enabled, documentation appears in AI Search results” etc.) so devs can track readiness in GitHub?
Contributor guide
Assessment
This issue has not been assessed yet.