TABLE OF CONTENTS
Overview
Stack Internal's content ingestion feature leverages the power of AI to quickly turn your internal documents into high-quality content on your Stack Internal site. This allows you to take static knowledge scattered across your organization and make it dynamic, accessible content your users can easily locate and integrate into their workflows.
In this quickstart guide, we'll cover the basic features of Stack Internal Ingestion. For a fuller explanation of all Ingestion features, go to the Ingestion support article index.
File ingestion process
File upload
In addition to automated ingestion of content from connectors (for example: Confluence Cloud), you can upload "ad hoc" files of many types directly into the Ingestion pipeline. Stack Internal Ingestion currently supports PDF files, markdown (text) files, several image file formats, as well as Microsoft Word, Excel, and Powerpoint files.
To access your site's Ingestion controls, click Ingestion in the left-hand menu under the "MANAGE" heading.
The Ingestion dashboard appears, showing the current status and recent history of Ingestion jobs. To add a new file for ingestion, click Upload files in the upper-right corner.
Drag one or more files into the "File Ingestion" box, or click choose your files to browse for files. You can upload a file in any of the supported file types.
On successful upload, you'll see a green confirmation message at the top of the page. Click View status to see the status of your upload. You can also click Done at the bottom of the page to view the Ingestion job list.
API file ingestion
In addition to manually uploading files, you can also add files to the Ingestion queue with Stack Internal's API v3. You can access your site's API v3 online documentation at https://[your_site].stackenterprise.co/api/v3. For details on API Ingestion, scroll down to the "Ingestion - Main" section. For more information on API v3, read the Stack Overflow Internal API v3 article.
File ingestion status
The Ingestion dashboard status table lists files from all sources: file upload, API, and connectors. You should see your new file listed near the top with a status of "Queued" or "Processing".
When the ingestion process is complete, you'll see your document's status listed as "Completed". You'll also see the number of Q&A pairs created from your uploaded content.
If you want to delete the Q&A pairs from a specific source file (for example: you uploaded the wrong document), click the three dots in the right-hand column. Click Delete all posts.
Ingestion content review
To review the posts created, click your document's name in the left-hand column. The Ingestion review page will appear.
The Ingestion review page shows one of the Q&A pairs created from your uploaded file. On the right-hand side of the page is the "Content score" box. This box shows AI-generated quality scores based on metrics including answer depth, coherence, knowledge value, and more. Questions and answers with a higher overall content score will generally provide more value to your users.
You can edit the AI-generated question and answer by clicking the Edit Question and Edit Answer buttons respectively. While editing the question, you can also add to or delete the suggested content tags. You can also add comments, even calling the attention of other users with the "@user" mention tag.
When you're satisfied with the quality of the content, publish it by setting the "Actions" selector to Verify and publish and clicking Submit. Until someone publishes the Q&A pair, it will be visible only to content reviewers.
If you choose to not keep the Q&A pair, you can delete it by setting the "Actions" selector to Delete and clicking Submit.
Lastly, you can skip the review of this Q&A pair by clicking Dismiss. You'll be shown another Q&A pair to review instead (if available). The content you're skipping remains in the review queue for others to review, and Stack Internal won't show you this Q&A pair again.
