> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/app/structural-ai-and-agent/managing-the-structural-agent-and-agent-chats.md).

# Managing the Structural Agent and Agent chats

## Managing the chat window

### Expanding the window to full page

By default, the agent displays as a panel next to the content of the current page.

To expand the agent to full screen, either:

* Click the full width icon.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FrXOGN2eYNScARzhZc2rn%2FAgent_FullScreenOption.png?alt=media&amp;token=57629c43-6e6e-4100-99c1-b477ed691607" alt=""><figcaption><p>Icon to expand the Structural Agent to full screen</p></figcaption></figure>

* In the options menu, click **Full screen**.

To switch back to a side panel, in the chat navigation panel, click the collapse icon.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FwnNbnI5WCfuv1xjWs5uN%2FAgent_ExitFullScreen.png?alt=media&amp;token=4d1f5733-87d6-468f-a307-ef34c4bd03df" alt=""><figcaption><p>Option to exit full screen mode for the Structural Agent</p></figcaption></figure>

The agent also collapses to the side panel automatically when you navigate to a different view in Structural.

### Adjusting the chat panel width

To adjust the chat panel width, click and drag the panel border.

### Changing the chat panel location

You can move the chat panel to the left or right of the Structural page.

To change the display location, from the chat options menu:

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FBASdLgVPI78hicOEa8nr%2FAgent_OptionsMenu.png?alt=media&amp;token=718de6e1-3e99-450c-b0dd-4d8567730209" alt=""><figcaption><p>Agent options menu that includes the options to move the Structural Agent</p></figcaption></figure>

* To move the chat panel to the left, click **Move to left side**.
* To move the chat panel to the right, click **Move to right side**.

### Hiding and displaying the chat panel

To hide the chat panel, either:

* Click the hide icon at the top right.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2F1hfQmRgiiHjcPQBl4ZDb%2FAgent_Hide.png?alt=media&amp;token=0e437dc8-39a7-4630-9e81-ab0d062bf13b" alt=""><figcaption><p>Hide icon to hide the Structural Agent</p></figcaption></figure>

* In the options menu, click **Hide AI agent**.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FBASdLgVPI78hicOEa8nr%2FAgent_OptionsMenu.png?alt=media&amp;token=718de6e1-3e99-450c-b0dd-4d8567730209" alt=""><figcaption><p>Agent options menu that includes the option to hide the Structural Agent</p></figcaption></figure>

To display the Structural Agent again, in the navigation panel, click the show agent icon.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FLtcHZcrfgqEw6TjeQWMt%2FAgent_ShowAgentOption.png?alt=media&amp;token=65fc0701-9816-4107-985a-77d13b767704" alt=""><figcaption><p>Navigation panel option to display the Structural Agent after it is hidden</p></figcaption></figure>

## Identifying the chat context

The Structural Agent chat remains in place across the entire Structural application.

You can read information about data from any workspace that you have access to. For example, you can get a summary list of workspaces organized by data connector, identify unprotected columns in any workspace, or find the workspace with the most recent failed job.

However, you can only perform configuration or generation actions based on the current context. For example, you can only change the configuration for a workspace if you are currently in the workspace management view for that workspace. The Structural Agent can navigate to the workspace that you want to work with.

As you navigate to different workspaces or to views outside of a workspace, the Structural Agent chat notes the change in context, and provides links to allow you to navigate to each context.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2F967x3QEJg7YbLqgplvBu%2FAgent_SwitchContext.png?alt=media&amp;token=4b47d8a8-973f-4603-9ef1-699dc301f9ee" alt=""><figcaption></figcaption></figure>

## Starting and managing chats

You can create multiple chats within the Structural Agent. For example, you might start a new chat when you change to a different workspace.

### How chats are stored

Tonic Structural stores chats in browser storage.

### Starting a new chat

To start a new chat, in the agent chat menu, select **New Chat**.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FASF6UXjJHp3WxOfmUqkv%2FAgent_ChatMenu.png?alt=media&amp;token=7094697c-49eb-4d4c-a6ac-343396bc0976" alt=""><figcaption><p>Chat menu that includes the option to create a new chat</p></figcaption></figure>

### Pinning chats

You pin a chat that you want to be able to return to easily. The navigation panel and chat menu provide access to your pinned chats.

#### Pinning the current chat

To pin the current chat, from the chat menu, select **Pin**.

#### Viewing the list of pinned chats

To view a list of pinned chats, you can expand the Structural navigation panel.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FREwCBEdJKHIKXZ66amav%2FNavigation_ExpandOption.png?alt=media&amp;token=59265b1c-4fc1-4539-b745-fd8d9a95e6d3" alt=""><figcaption><p>Option to expand the Structural navigation panel</p></figcaption></figure>

The navigation panel displays the list of pinned chats.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2Fhjwk8SPIbig2KAarxwNK%2FNavigation_Expanded.png?alt=media&amp;token=46c31bc2-9313-4dab-941e-a4c5f6e0a3d8" alt=""><figcaption><p>Expanded Structural navigation panel with the list of pinned chats</p></figcaption></figure>

The chat menu also lists the pinned chats.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FYjafKBYraLbBRF0tC2Dz%2FAgent_ChatMenuPinnedChat.png?alt=media&amp;token=1a955dcc-8b8a-4ed9-8ebc-a8d05a8aa37f" alt=""><figcaption><p>Chat menu with the list of pinned chats</p></figcaption></figure>

#### Opening a pinned chat

To open a pinned chat in the agent panel, in the **Pinned Chats** list, click the chat name.

#### Unpinning the current chat

When the current chat is pinned, to unpin the chat, from the chat menu, select **Unpin**.

### Viewing and opening recent chats

The **Recent Chats** list contains chats that you have viewed or interacted with most recently.

The expanded Structural navigation panel displays the list of recent chats.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2Fhjwk8SPIbig2KAarxwNK%2FNavigation_Expanded.png?alt=media&amp;token=46c31bc2-9313-4dab-941e-a4c5f6e0a3d8" alt=""><figcaption><p>Expanded Structural navigation panel with the list of recent chats</p></figcaption></figure>

The chat menu also displays recent chats.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FYjafKBYraLbBRF0tC2Dz%2FAgent_ChatMenuPinnedChat.png?alt=media&amp;token=1a955dcc-8b8a-4ed9-8ebc-a8d05a8aa37f" alt=""><figcaption><p>Chat menu with the list of recent chats</p></figcaption></figure>

To open a recent chat, in the **Recent Chats** list, click the chat name.

### Renaming a chat

The chat name identifies the chat in the chat lists.

The agent automatically assigns a name based on the initial chat prompt.

To change the name of the current chat:

1. In the chat menu, click **Rename**.
2. Provide the new chat name.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FJRnGnqmtL3du1zsXYpOD%2FAgent_RenameChat.png?alt=media&amp;token=1c43697a-21cb-4fd1-8e81-0c7855dbcb9f" alt=""><figcaption><p>Panel to rename the current chat</p></figcaption></figure>

3. Click **Save**.

### Deleting a chat

You can delete a chat that you no longer need.

To delete the current chat, in the chat menu, click **Delete**.

## Managing chat prompts and actions

### Stopping an action

While the Agent is working, to stop the response and cancel the action, in the chat prompt, click the stop response icon.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FdX6laHuZkrqu14F1aFxk%2FAgent_StopResponse.png?alt=media&amp;token=980aed3c-de77-4450-9ce5-ac385f9985d7" alt=""><figcaption><p>Stop response icon in the Structural Agent chat prompt</p></figcaption></figure>

### Undoing and redoing an action

Before it performs an action to modify the workspace, the Agent takes snapshots of the current workspace configuration.

To undo an action, or to revert to a previous point from the current conversation, prompt the Agent.

For example:

* `Undo that action.`
* `Revert the generator assignments for the datetime columns.`
* `Go back to before we assigned generators to the name columns.`

If needed, the Agent can ask you to select a snapshot to revert to.

To redo an action, cick the redo icon.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FdM93rLY5TeuaexZdnrDK%2FAgent_RedoIcon.png?alt=media&amp;token=b57ac384-b28a-4d79-9377-bfdd0187c687" alt=""><figcaption><p>Redo icon for the Structural Agent</p></figcaption></figure>

### Copying the most recent response from the Agent

A response from the Agent might be useful elsewhere. For example, you can prompt the Agent to generate Structural API calls, or the Agent might return a useful summary of the data and its status.

To copy the most recent Agent response, click the copy icon.

<figure><img src="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FtWIEyfUMWq8M9LHiTgxM%2FAgent_CopyResponse.png?alt=media&amp;token=d37c5ef2-b65e-4eb5-a02c-868dbe6ec771" alt=""><figcaption><p>Copy response icon for the Structural Agent</p></figcaption></figure>

### Providing feedback to the Agent

You can provide basic positive or negative feedback to indicate the helpfulness of a response. The Agent then uses that feedback to adjust its future responses in the current chat.

To provide positive feedback, click the thumbs up icon.

To provide negative feedback, click the thumbs down icon.


---

# 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.tonic.ai/app/structural-ai-and-agent/managing-the-structural-agent-and-agent-chats.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.
