Workspaces
Pages Fabric Agent writes for your organization from a description, shared with everyone in it by default, with buttons that act through Fabric.
A Workspace is a page that Fabric Agent writes for your organization: a delivery board, a weekly digest, a list of open decisions, a small tool with a refresh button. You describe what you want to see, the agent writes the whole page, saves it, opens it and explains what it shows. Nothing on the page is a template, so asking for a new section or a different layout simply rewrites the page.
Workspaces used to be the name of the document libraries. Those are called Libraries now, and their page is described in Libraries. Workspaces are a different feature: pages, not documents.
Ask for a Workspace
Open Workspaces
Click Workspaces in the left sidebar. The page lists every Workspace you can open.
Click New workspace
Fabric Agent opens with a draft such as "Create a new Workspace that shows". Finish the sentence — "this week's delivery status by project", "the decisions that are still open" — and send it.
Read what it wrote
The agent writes the page, saves it as a Workspace and opens it, with a short explanation of what each part shows. If something is wrong, say so in the same chat, or open the page and click Ask Fabric Agent to change it.
You can also ask from any chat with Fabric Agent: "make me a Workspace with a board of this sprint's work". A chat opened from a Workspace knows which page you are on, so "add a column for blockers" changes that page.
Who can open a Workspace
A new Workspace is shared with everyone in your organization. If a page should stay yours alone, say so when you ask ("keep it private") and the agent saves it as private. Each card in the list shows who the page is shared with.
| Shown as | Who can open it |
|---|---|
| Organization | Every member of your organization |
| Private | Only you (and, for a page linked to a project, the members of that project) |
| Invited | The people you invited by email |
| Project | The accepted members of its project |
| Public | Anyone with the link, signed in or not |
The list shows the Workspaces you wrote, the ones shared with your organization, and those linked to a project you can open. A guest of a single project, who is not a member of the organization, does not see the list; they can still open a page someone shares with them.
The person who wrote a Workspace changes who can open it from the Share control in the page header, and sees the page's earlier versions under Version history, where any version can be restored. Only the author can do either, and only the author's Fabric Agent chat can change the page. Everyone else can read it, and can ask Fabric Agent to write a similar page of their own.
Buttons that act through Fabric
A page can have buttons that do things in Fabric: a Refresh that reads the current numbers, a Run now that starts a workflow, a link into a project. The page cannot reach Fabric on its own; it asks the page around it, and that page decides, as you.
The page's script has three functions, all on window.fabric:
| Function | What it does |
|---|---|
fabric.call(tool, args) | Runs a Fabric tool, such as listing projects or starting a workflow, and returns its result |
fabric.openAgent(prompt) | Opens Fabric Agent with prompt as a draft; you still have to send it |
fabric.navigate(path) | Takes you to another page of the app (a path that starts with /app/) |
How a call is treated:
- The page declares its tools when it is saved. It can call only those. A tool it did not declare is refused.
- Reading runs at once. Tools that only read, such as listing projects or documents, run without asking.
- Changing asks you first. A tool that can change something shows you what the page wants to do, including every value it would send, and runs only if you allow it. Your yes holds for that tool on that version of the page until you close the browser tab. When the page is edited, you are asked again.
- A few tools are never available to a page: switching organization, requesting or revoking authority, sharing a frame publicly, creating, editing or publishing a workflow, and creating or editing a frame. Asking Fabric Agent is the way to do those.
- A page runs for the organization you are looking at. If the page does not belong to it, every call is refused.
- There is a limit of 30 calls a minute for one page.
What a page cannot do
A Workspace runs in a locked frame. It cannot make network requests, read your cookies or storage, load scripts, styles or fonts from another site, or open other pages inside itself. Images and fonts have to be embedded in the page. This keeps a page somebody else wrote from sending what it shows anywhere else.
A page that a scheduled workflow wrote with nobody watching is shown without any script, so it reads as a static report. Pages written in a chat keep their buttons.
On a public link, buttons that call Fabric do not work: there is no signed-in person for them to act as.
Related
- Project Artifacts, the same kind of page, kept with one project
- Scheduled agent workflows, which can publish a fresh page on a schedule
- Fabric MCP Gateway, the tools a page calls