> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/knowledge-and-retrieval/import-from-an-external-source.md).

# Import from an external source

Website import adds webpage content to a knowledge base. Use an explicit URL list when you want to control which pages enter the searchable collection.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F9RghFJU7PVwkAoywggCb%2FG037.mp4?alt=media&token=70914ca7-84bf-4839-8a85-4d018a628514>" %}

## Before you start

Use webpages that can be read without an interactive sign-in. For provider files such as Google Drive documents, use [Import selected Google Drive files](https://docs.stackai.com/guides-and-quickstarts/knowledge-and-retrieval/import-selected-google-drive-files.md). Decide which URLs belong in the collection before importing.

## Choose webpage import

In the knowledge base, choose Import from a Website and select the manual URL-list option.

![Website import method selection](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/sQfe3VUZZTQIR17DdoDE/assets/g037-g037-01-start.png)

Use this option when you need to specify the individual pages to import.

## Add the page URLs

Add one page URL per row and review the complete paths.

![Website import URL list](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/4ufoWwWQ2PcqonYycjKe/assets/g037-g037-02-urls.png)

The list defines which webpages are included in the import.

## Import and inspect the pages

Select Import Webpages, then browse the imported domain and folders.

![Imported webpage content inspection](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/3MtdNLwr4Q1nSTQB3aQX/assets/g037-g037-03-indexed.png)

Check each file's processing status before using it for retrieval.

Open an imported document and inspect Preview or Parsed, then Chunks.

![Imported webpage content inspection](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/v14NFTGrWpwA6qD0mA9E/assets/g037-g037-04-parsed.png)

Confirm that the extracted content is the intended page rather than an error or sign-in page.

## Update the URL list

Use Change Website to edit the saved URL list.

![Saved website URL selection](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/0pj8oaOw1q4GNlpaZ4rA/assets/g037-g037-05-scope.png)

Save the updated list when you want to change which pages are imported.

## Search the imported content

Open Evaluate, enter a question about the imported content, and select Execute.

![Imported webpage retrieval results](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/fa33xRjdKQVocZ2xL4CY/assets/g037-g037-06-result.png)

Expand a relevant result to read the passage returned by retrieval.

Check the result's source filename and attribution.

![Imported webpage retrieval results](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/EVBa7zAgPfbfp4ZWkVHB/assets/g037-g037-07-source.png)

The source should support the information in the passage you plan to use.

## Important behavior

Check that extracted content is the intended webpage. Pages that require sign-in or return an error may not provide usable content.

## Continue

* [Sync and ingestion lifecycle](https://docs.stackai.com/guides-and-quickstarts/knowledge-and-retrieval/sync-and-ingestion-lifecycle.md)
* [Evaluate retrieval](https://docs.stackai.com/guides-and-quickstarts/knowledge-and-retrieval/evaluate-retrieval.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/guides-and-quickstarts/knowledge-and-retrieval/import-from-an-external-source.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
