> 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/inspect-knowledge-base-references.md).

# Inspect knowledge base references

References lists the projects that use a knowledge base. Use it to understand dependencies before changing shared sources or removing a collection.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F7NTrx621cA6dXlkPzIj5%2FG044.mp4?alt=media&token=2ae61153-73fe-4943-99fe-cddf181aea6a>" %}

## Before you start

Open the knowledge base you intend to change. You need access to each consuming project to inspect its configuration; ask the project owner for help if View Project is unavailable.

## Find consuming projects

Open References to see which projects use the knowledge base.

![Knowledge base project references](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/x7l6jJQEQUsKiKd3hiKK/assets/g044-g044-01-references.png)

Identify affected projects before changing or removing shared source content.

## Inspect workflow retrieval settings

Use View Project to open a workflow and inspect its knowledge-base node.

![Workflow knowledge base search settings](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/4yBtCYGm8CWUVwUINdYm/assets/g044-g044-02-workflow.png)

Confirm which base is attached and which sources it contains.

Review the node's input query and Search Parameters.

![Workflow knowledge base search settings](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/n8MXY6VuG7MJeuA8yBBd/assets/g044-g044-03-search.png)

Filters and retrieval settings can make two consumers of the same base return different results.

## Inspect an agent’s knowledge sources

Open an agent listed in References and inspect its Knowledge sources.

![Agent knowledge source configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/2T4MHPJYY1g0chOM5o66/assets/g044-g044-04-agent.png)

Confirm that it uses the same base and review the instructions that govern retrieval.

## Review the effect of source changes

Inspect important source content before changing it, then check the consuming projects after the update.

![Shared source change review](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/2HtmNbo7qlmXknwzC7RT/assets/g044-g044-05-source.png)

Use their normal questions and source evidence to confirm the effect of the change.

## Important behavior

Projects can use different queries, filters, and search settings with the same knowledge base. These settings can produce different results.

## Continue

* [Knowledge base maintenance](https://docs.stackai.com/guides-and-quickstarts/knowledge-and-retrieval/knowledge-base-maintenance.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/inspect-knowledge-base-references.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.
