What the buyer should understand.
The document inventory makes ingestion health visible before a buyer trusts grounded answers. For document inventory, the important buyer proof is simple: Open the document inventory path in the Satinash client, perform the normal user action for the Documents workflow, and verify the visible state, evidence, limits, or artifact output that confirms the capability completed its job. A strong demo narrates the user action, then pauses on the visible state before moving on: the active scope, the eligible sources or tools, the status message, the artifact output, the limit state, and the next action that a normal user can take. The evaluator leaves knowing that this is a flagship proof point shown early in a buyer demo because it anchors the broader Satinash story, how it is governed, and which adjacent features to test next.
the document inventory, document detail views, processing status filters, retry actions, citation-to-document paths, and source metadata panels
Filter by source, dataset, status, processing health, or read/parse issue. In the document inventory documentation, this step includes the user-visible confirmation, the expected state change, and the reason the step matters to the buyer's evaluation checklist.
Primary proof surface: Open the document inventory path in the Satinash client, perform the normal user action for the Documents workflow, and verify the visible state, evidence, limits, or artifact output that confirms the capability completed its job. The evaluator sees the user action and the confirmation in the same flow, then identifies the exact state, table row, message, preview, control, citation, diagnostic, or output that proves document inventory worked.
What Document inventory solves
Document inventory solves the client-side problem described by its product summary: a workspace table shows indexed files, source, dataset, status, and detail. The feature is documented as a workflow a buyer can run in Satinash, with a visible beginning, a visible state change, and an inspection surface that confirms the work happened.
The strongest use case is not generic AI productivity. It is the specific documents moment where support operators, implementation leads, and knowledge owners who need to know whether private files are actually ready to answer from need to decide whether a file is ready, pending, stale, skipped, deleted, or failing, whether a failed document needs a retry or a source-side repair, whether an answer citation points to a serving document profile, and whether source removal has revoked retrieval access immediately. The page keeps that decision in view so the reader understands the job, the product surface, and the business reason for the capability.
Where it appears in the client
Document inventory appears around the document inventory, document detail views, processing status filters, retry actions, citation-to-document paths, and source metadata panels. Those locations give the buyer a concrete route through the product instead of a feature claim that only exists in a slide deck.
The relevant client objects are document identity, dataset relation, processing status, read errors, parse errors, serving profile, and source metadata. When the feature is evaluated, each object either provides scope, proves readiness, explains a limit, or shows the next action available to the user.
Proof surfaces and pitfalls
The primary proof surface is retry actions that clear the relevant issue and requeue work without pretending success; the secondary proof surface is citation paths that let a buyer connect an answer back to document readiness. Together they show the action, the state, and the evidence path a buyer can inspect during or after the demo.
The main pitfall is retrying without first checking whether the source, model, or dataset state still blocks work. A second pitfall is assuming deleted relations can still serve retrieval after access has been revoked. The documentation names both because long-form feature pages need to explain how a buyer can misread the workflow and how the client UI resolves that confusion.
What the user gets.
What it solves: Document inventory addresses a concrete client-side problem in Satinash: a workspace table shows indexed files, source, dataset, status, and detail. It keeps the discussion anchored in a workflow a buyer can actually run, not a broad AI claim. The documentation explains the moment of need, the risk of doing the work manually, and the reason this capability belongs in the product rather than in a training note or sales promise.
Where it appears: Document inventory lives around the document inventory, document detail views, processing status filters, retry actions, citation-to-document paths, and source metadata panels. The relevant user is usually support operators, implementation leads, and knowledge owners who need to know whether private files are actually ready to answer from. During evaluation, the buyer can point to the control, table, drawer, route, preview, or status label that makes the capability visible, then follow it into the next Satinash surface without asking for hidden context.
User outcome: A single inventory of dataset-backed documents with source, dataset, status, and detail surfaces. For document inventory, that outcome is strongest when the user can start from a real task, see the scope and state, complete the action, and understand what changed. The before-and-after is clear enough that a stakeholder can retell the workflow after the demo.
Operational context: Readable processing states that distinguish pending, queued, processing, stale, skipped, deleted, and errors. The feature works with document identity, dataset relation, processing status, read errors, parse errors, serving profile, and source metadata. Those objects matter because they tell buyers what must already exist, what can be configured by a workspace user, and what needs inspection when the result looks different from expectation.
Decision support: Document inventory helps teams decide whether a file is ready, pending, stale, skipped, deleted, or failing, whether a failed document needs a retry or a source-side repair, whether an answer citation points to a serving document profile, and whether source removal has revoked retrieval access immediately. The documentation states those decisions directly so the page works as an evaluation aid, a sales leave-behind, and a product reference for people who were not in the live demo.
Related features: compare Document inventory with Document processing health, and Manual document retry. Those nearby pages give the evaluator the rest of the workflow: the source setup, the control surface, the evidence trail, and the operational follow-through. Linking the pages this way keeps the 100-feature catalog from feeling like isolated fragments.
Scope boundary: Document pages make processing health visible without turning the buyer page into parser internals or database schema documentation. For document inventory, that boundary is important because the marketing content describes visible client behavior and buyer evidence while staying out of operator-only setup details unless they explain what the user can inspect.
Workflow documentation.
- Open the document inventory for a workspace or dataset-backed source. Start the walkthrough by naming Document inventory, the user role, and the current client location. Show the buyer exactly where the workflow begins, what object is selected, and which visible state tells the user the page is ready for action.
- Filter by source, dataset, status, processing health, or read/parse issue. In the document inventory documentation, this step includes the user-visible confirmation, the expected state change, and the reason the step matters to the buyer's evaluation checklist.
- Inspect a document detail page to see source identity, dataset relation, and serving profile state. In the document inventory documentation, this step includes the user-visible confirmation, the expected state change, and the reason the step matters to the buyer's evaluation checklist.
- Retry failed or stale processing when the source and plan allow it. In the document inventory documentation, this step includes the user-visible confirmation, the expected state change, and the reason the step matters to the buyer's evaluation checklist.
- Return to chat or Core setup knowing which documents are actually eligible to serve. In the document inventory documentation, this step includes the user-visible confirmation, the expected state change, and the reason the step matters to the buyer's evaluation checklist.
- Check configuration before judging the result. For Document inventory, configuration includes document identity, dataset relation, processing status, and read errors, plus the category-level controls listed in the page. A useful evaluation names which settings were chosen, which were inherited from a Core, plan, connector, dataset, or workspace, and which settings are intentionally not part of this feature.
- Inspect proof before moving to the next page. The best proof surface for this pass is retry actions that clear the relevant issue and requeue work without pretending success. If that surface is absent, the demo stops and explains why, because buyer confidence depends on seeing the evidence trail rather than hearing that it exists somewhere else.
- Close the workflow by comparing the result with Document processing health, and Manual document retry. That comparison helps the evaluator understand whether document inventory is the entry point, the supporting control, the repair path, or the trust signal inside the larger documents story.
Proof, configuration, and buyer concerns.
Proof to inspect
- Primary proof surface: Open the document inventory path in the Satinash client, perform the normal user action for the Documents workflow, and verify the visible state, evidence, limits, or artifact output that confirms the capability completed its job. The evaluator sees the user action and the confirmation in the same flow, then identifies the exact state, table row, message, preview, control, citation, diagnostic, or output that proves document inventory worked.
- Category proof: Show one merged status token per document and a loading animation only for active processing. Tie this proof to Document inventory by naming the source object, status, or control that changed. A buyer does not have to infer whether the feature is active; the surface makes the active state legible.
- Evidence trail: retry actions that clear the relevant issue and requeue work without pretending success. This is the surface to pause on during a demo because it shows how Satinash keeps the workflow inspectable after the initial click, message, upload, scan, connection, plan check, or widget preview.
- Secondary evidence: citation paths that let a buyer connect an answer back to document readiness. This gives reviewers a second way to validate the same claim, which is useful when the buyer cares about support handoff, source governance, billing transparency, reliability, or daily user adoption.
- Evaluation checklist: Retry a stale or failed document and confirm the status changes only when work is actually claimed or completed. For document inventory, record the expected result, the state that changed, and the related feature that would be tested next. That turns the page into a reusable checklist rather than a prose-only description.
- Table-friendly facts: Document inventory; slug document-inventory; category Documents; fit primary; route /features/document-inventory/; works with document inventory, processing states, retries, chunks, vectors, and source metadata; primary users support operators, implementation leads, and knowledge owners who need to know whether private files are actually ready to answer from; related features Document processing health, and Manual document retry. These facts are intentionally compact so comparison tables and sales notes can reuse them without rewriting the page.
- Buyer proof question: if a skeptical reviewer asks where document inventory appears, what it depends on, and how to know it worked, the answer points to the document inventory, document detail views, processing status filters, retry actions, citation-to-document paths, and source metadata panels, document identity, dataset relation, processing status, read errors, parse errors, serving profile, and source metadata, and the visible proof surfaces above.
Configuration notes
- Configuration model: Document inventory appears in the Documents client experience through visible controls, status labels, evidence panels, and adjacent workflows that evaluators can inspect without relying on behind-the-scenes implementation details. In practical terms, Document inventory is shaped by Document status filters, dataset relation state, source metadata, and retry actions., plus the category objects document identity, dataset relation, processing status, read errors, parse errors, serving profile, and source metadata. User-facing choices are separated from inherited workspace, Core, connector, dataset, or plan state so evaluators know what can be changed during normal use.
- Setup checklist: Ingestion profile, embedding model, shared profile readiness, and serving profile promotion. Before a demo, confirm the prerequisites are present and visible. If the feature depends on a Core, dataset, connector, widget, plan, upload, or role, the docs identify how that dependency appears to the user and what message appears when it is missing or inactive.
- Limits, plan context, and table facts: Quota warnings, stale detection, deleted visibility, and orphan cleanup windows. The buyer does not need internal limit enforcement details, but they do need to know which capacity, model, connector, upload, document, widget, or team boundary can affect document inventory. Table-ready configuration facts: Route family: document inventory and document detail surfaces, Primary evidence: merged status token, source metadata, dataset relation, retry state, and error detail, Main dependencies: dataset scans, ingestion profile, embedding model, parser result, and retention rules, and Buyer signal: ingestion health is visible before buyers judge answer quality.
- Pitfall to avoid: retrying without first checking whether the source, model, or dataset state still blocks work. Second pitfall to avoid: assuming deleted relations can still serve retrieval after access has been revoked. The evaluation record captures chosen configuration, visible state before and after the action, proof surface inspected, and related feature tested next so stakeholders can compare the feature across accounts without relying on memory.
Buyer concerns
Where does document inventory show up for an end user? It appears around the document inventory, document detail views, processing status filters, retry actions, citation-to-document paths, and source metadata panels. The answer points to the route, panel, table, drawer, composer control, preview, status chip, or action row that makes the capability visible in the product.
Can users see why an answer did or did not use a file? For Document inventory, the answer is visible in the active scope, the category-specific source objects, and the first proof surface. The buyer understands whether the feature uses approved knowledge, selected tools, a Core setting, a connector state, a plan allowance, or a public widget boundary.
Can support teams repair failed documents without waiting on engineering? That concern becomes a concrete evaluation check: Remove source access and verify retrieval depends on an active dataset relation and processed serving profile. The buyer needs a visible pass or fail condition, not a vague assurance that the product can handle it.
Are stale, skipped, deleted, and processing states visibly different? If the concern appears during a live demo, pause on the pitfall called out above, then show the status or configuration that resolves it. That pattern teaches evaluators how to self-serve the next time they see the same behavior.
How does a buyer compare this with related features? Start with Document processing health, and Manual document retry. If Document inventory is the control, the related pages usually show the source setup, the output, the repair path, or the trust evidence that surrounds it.
What gets documented after evaluation? Capture the user role, the exact workflow, the dependency objects, the configuration choices, the proof surfaces inspected, the pitfalls observed, and the next related feature to validate. That makes document inventory useful as long-form documentation rather than a short marketing blurb.
Evaluation tables.
These tables turn the documentation into something a buyer, sales engineer, or implementation lead can inspect during a live walkthrough.
Evaluation checklist
| Check | What to inspect | Why it matters |
|---|---|---|
| Start with a real task | Retry a stale or failed document and confirm the status changes only when work is actually claimed or completed. The task uses a realistic customer question and the same source, tool, plan, role, or widget context the buyer expects in production. | This proves Document inventory in the context where it will actually be used, rather than as an isolated demo click. |
| Confirm visible scope | Inspect the document inventory, document detail views, processing status filters, retry actions, citation-to-document paths, and source metadata panels and identify the active objects: document identity, dataset relation, processing status, read errors, parse errors, serving profile, and source metadata. | The buyer can see what is eligible, what is excluded, and which setting explains the result. |
| Inspect proof | Pause on retry actions that clear the relevant issue and requeue work without pretending success and citation paths that let a buyer connect an answer back to document readiness; record the state before and after the user action. | The feature is accepted on product evidence, not on a verbal promise. |
| Compare adjacent features | Continue into Document processing health, and Manual document retry after the first pass. | The buyer sees how Document inventory fits into the rest of the documents workflow and which capability answers the next concern. |
Proof matrix
| Evidence | Product proof | Buyer value |
|---|---|---|
| Visible proof | Open the document inventory path in the Satinash client, perform the normal user action for the Documents workflow, and verify the visible state, evidence, limits, or artifact output that confirms the capability completed its job. | Shows the exact client evidence a buyer can inspect during the feature walkthrough. |
| Category proof | Show one merged status token per document and a loading animation only for active processing. | Connects Document inventory to the broader Documents evaluation story. |
| Failure or limit proof | Pitfall to avoid: retrying without first checking whether the source, model, or dataset state still blocks work. | Makes confusing states understandable before they become objections. |
| Related proof | Related features: Document processing health, and Manual document retry. | Gives the evaluator a next page when they need source setup, output review, repair, or governance evidence. |
Configuration matrix
| Area | Control or dependency | Impact |
|---|---|---|
| Primary configuration | Document status filters, dataset relation state, source metadata, and retry actions. | Explains the main control or inherited setting that shapes document inventory. |
| Prerequisites | Required or relevant objects: document identity, dataset relation, processing status, read errors, parse errors, serving profile, and source metadata. | Keeps the demo honest about what must exist before the feature can prove value. |
| Limits | Quota warnings, stale detection, deleted visibility, and orphan cleanup windows. | Connects blocked, unavailable, or over-limit behavior to visible product guidance. |
| Table facts | Route family: document inventory and document detail surfaces, Primary evidence: merged status token, source metadata, dataset relation, retry state, and error detail, Main dependencies: dataset scans, ingestion profile, embedding model, parser result, and retention rules, and Buyer signal: ingestion health is visible before buyers judge answer quality | Provides compact comparison data for sales notes, buyer checklists, and category pages. |
Workflow map.
Best practices
- Retry a stale or failed document and confirm the status changes only when work is actually claimed or completed.
- Remove source access and verify retrieval depends on an active dataset relation and processed serving profile.
- Record the route /features/document-inventory/, proof surfaces, configuration state, and related features Document processing health, and Manual document retry.
- Use the feature with the user audience executive evaluators, department leads, and first pilot teams so the evaluation reflects the intended rollout path.
Limits to discuss
- retrying without first checking whether the source, model, or dataset state still blocks work
- assuming deleted relations can still serve retrieval after access has been revoked
- primary documentation proves the happy path, the visible limits, and the recovery behavior because the capability shapes trust in the rest of the platform
- Document pages make processing health visible without turning the buyer page into parser internals or database schema documentation.
Terms buyers will hear.
| Term | Definition | Use in evaluation |
|---|---|---|
| Feature route | /features/document-inventory/ | Canonical URL for the buyer-facing documentation page. |
| Feature fit | primary: a flagship proof point shown early in a buyer demo because it anchors the broader Satinash story. | Explains whether the feature is a flagship, focused, supporting, or trust-oriented page. |
| Primary users | support operators, implementation leads, and knowledge owners who need to know whether private files are actually ready to answer from | Clarifies who must understand and validate the workflow. |
| Works with | document inventory, processing states, retries, chunks, vectors, and source metadata | Lists the adjacent product areas that shape the feature in use. |