> 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/interfaces-and-end-user-experiences/use-a-published-chat.md).

# Use a published chat

A published chat gives users access to a workflow through a conversation. The interface configuration determines which inputs, source references, and feedback controls are available.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FssXhVMon6oHDT9I9khKG%2FG062.mp4?alt=media&token=acdda926-481b-490a-a883-8da1fe9255a4>" %}

## Before you start

Have the published assistant link or locate it in Published Agents. If access is denied, ask the assistant owner to confirm your access rather than requesting project editing permission.

## Open the assistant

Open the published assistant and complete its configured access check.

![Published assistant welcome view](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/BCd7ODckw049A2hi73cI/assets/g062-g062-01-welcome.png)

Read the welcome text and review the available conversation controls.

## Ask a question and read sources

Submit a question that the assistant's sources can answer.

![Chat response and source references](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/0YM7wYiz7bF6SXYugOzp/assets/g062-g062-02-answer.png)

Wait for the response and look for its source markers when citations are enabled.

Open a citation or source control and read the supporting passage.

![Chat response and source references](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/Tf61fWTleyhiAvzA757A/assets/g062-g062-03-source.png)

Check that the source actually supports the statement in the answer.

## Attach a file

Use the attachment control when the assistant supports file input, then ask about the attached content.

![Chat file attachment controls](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/nGtX4hmsxy4gkmOIxT0B/assets/g062-g062-04-attachment.png)

Confirm that the file is accepted before relying on an answer about it.

## Give feedback

Rate the response with the available feedback control.

![Chat response feedback controls](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/9vxKqN2M2KfBsSQd80h9/assets/g062-g062-05-feedback.png)

Add a specific comment when you need to explain a missing detail or incorrect result.

## Continue or start a conversation

Ask a related follow-up in the same conversation.

![Chat continuation and conversation history](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/tkEpEIlagZ96ZqZcCaat/assets/g062-g062-06-followup.png)

The available context depends on the assistant’s conversation-memory configuration.

Choose New Conversation when you want to start a separate exchange.

![Chat continuation and conversation history](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/6qHVQbbUUYJMf1NIei0y/assets/g062-g062-07-new.png)

Use conversation history to return to earlier conversations when available.

## Important behavior

Citations, attachments, feedback, and conversation history appear only when enabled for the interface.

Read the cited passage when you need to check the source of a statement.

## Continue

* [Share a conversation](https://docs.stackai.com/guides-and-quickstarts/interfaces-and-end-user-experiences/share-a-conversation.md)
* [Published Agents catalog](https://docs.stackai.com/guides-and-quickstarts/interfaces-and-end-user-experiences/published-agents-catalog.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/interfaces-and-end-user-experiences/use-a-published-chat.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.
