What the assistant can read
A connected assistant can read across your Assemblified data and your live Shopify catalog. With a read-only connection it cannot change anything — see Read-only by default; with write access it can additionally create and update BOMs, sub-assemblies, and raw materials — see the operating pages in this section. This page lists the read surface so you know what you can ask about.
On this page
Section titled “On this page”- The data it can reach
- How it explores the API
- Reading the documentation
- What’s not included
The data it can reach
Section titled “The data it can reach”The assistant can read across these areas, scoped to your single store:
| Area | What it can see |
|---|---|
| Bills of materials | Your finished goods and their full composition — component materials, nested sub-assembliesSub-AssemblyA reusable assembly block that composes into bigger BOMs. Define it once, include it in any BOM. At execution time, Assemblified expands the sub-assembly into its own components recursively. Read more → , quantities, settings, and per-row usage. Search, filter (used / unused, by vendor), and sort just like the app’s list. |
| Buildable quantities | For any BOM, how many units you can build right now, per location — the same number the app’s Max Buildable column shows — including the sellable split and which components are the limiting factor. |
| Sub-assemblies | Your reusable sub-assemblies and their hydrated component trees, with usage counts. |
| Raw materials | Every raw material — Shopify-linked and virtualVirtual MaterialA material tracked entirely inside Assemblified — not a Shopify variant. Useful for shop-floor consumables (glue, packaging, labour units) where you need quantity tracking but don't want a Shopify product on your storefront. Read more → — with its per-BOM and per-sub-assembly usage, vendor, SKU, and (optionally) the BOMs and sub-assemblies that reference it. |
| Shopify catalog | Your live Shopify products and variants, searchable with Shopify’s own filter syntax, plus lookups by id — so the assistant can find the right variant before registering it as a material. |
| Locations | Your Shopify locations, so the assistant can resolve location names and ids. |
| Inventory levels | Real per-location stock for any material — live Shopify levels for Shopify-linked materials, app-tracked levels for virtual ones. |
| Pre-assembled stock | Per-location pre-assembledPre-Assembled InventoryStock of finished sub-assemblies and BOM items that have already been built and are sitting on the shelf. When a work order needs a sub-assembly, it draws from pre-assembled inventory first and only builds fresh ones if the shelf comes up short. Read more → quantities for your finished goods and sub-assemblies. |
How it explores the API
Section titled “How it explores the API”The assistant doesn’t have to guess what’s available. Alongside run, it can call describe_api, which returns the live, typed definition of everything it can reach — every area above, the inputs each accepts, and the shape of what comes back. This is how a capable assistant figures out, on its own, how to answer a question like “which BOMs am I about to run out of components for?”
Reading the documentation
Section titled “Reading the documentation”The assistant can also read this documentation site through two tools:
list_docs— the index of every documentation page.get_doc— the full text of one page.
This lets it ground its answers in how Assemblified actually works — what a BOMBill of MaterialsA bill of materials tells Assemblified how to build one unit of a finished good. When a customer orders the finished-good variant, Assemblified deducts the right component quantities from inventory automatically. Read more → is, how pre-assembled stockPre-Assembled InventoryStock of finished sub-assemblies and BOM items that have already been built and are sitting on the shelf. When a work order needs a sub-assembly, it draws from pre-assembled inventory first and only builds fresh ones if the shelf comes up short. Read more → works, what the buildable calculation includes — instead of guessing.
What’s not included
Section titled “What’s not included”- Writing without write access. A read-only connection can’t create or change anything. With a write-scope connection the assistant can operate BOMs, sub-assemblies, and raw materials — see the operating pages in this section.
- Changing your Shopify catalog. The Shopify catalog and real inventory levels are always read-only through this surface — the assistant reads them to find and reference variants, but it doesn’t edit your Shopify products or push inventory there.
See also
Section titled “See also”- AI / Agent access overview — how code mode works.
- Managing access & security — how access is scoped and revoked.