> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langchain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage agent settings

> Manage your agents in Fleet.

This page explains how to manage the settings for your agents in LangSmith Fleet.

## Change the model

To change the model for your agent:

1. In the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-fleet-manage-agent-settings), navigate to your agent's inbox.
2. Next to the agent name, click the <Icon icon="pencil" /> **Edit Agent** icon.
3. In the top right corner, click the <Icon icon="settings" /> **Settings** icon.
4. Select the **Model** you want to use.
5. Enter the API key for the model.

For information on how to add a custom model, see [Custom models](/langsmith/fleet/essentials#custom-models).

## Reconnect tool integrations

To reconnect a tool integration to an agent:

1. In the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-fleet-manage-agent-settings), navigate to your agent's inbox.
2. Next to the agent name, click the <Icon icon="pencil" /> **Edit Agent** icon.
3. In the top right corner, click the <Icon icon="settings" /> **Settings** icon.
4. In the **Connected Integrations** section, click the **Connect** button next to the tool you want to reconnect.

## Download agent files

To download the files for your agent, click the <Icon icon="settings" /> **Settings** icon in the top right corner of the agent and select **Download ZIP**. This will export the agent configuration as a ZIP file.

## Change access to the agent

Agents can either be private to the creator or shared within a LangSmith workspace.

| Feature                  | Private agents                          | [Workspace agents](#workspace-scoped-agent-details)                                                                    |
| ------------------------ | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Ownership and access** | Only visible to creator                 | Visible to anyone within the same LangSmith workspace                                                                  |
| **OAuth authentication** | OAuth credentials are scoped to creator | OAuth credentials are scoped to each user; new users cloning workspace agents must re-authenticate with selected tools |
| **Secrets**              | Uses workspace-scoped LangSmith secrets | Uses workspace-scoped LangSmith secrets (same as private agents)                                                       |

To change the agent visibility, click the <Icon icon="lock" /> **Visibility settings** icon in the top right corner of the agent and select either **Only me** or **Workspace**.

### Workspace-scoped agent details

While workspace-scoped agents are shared, some details are public, while others are private:

* **Threads are always user-scoped**, so even if an agent is workspace-scoped, the chat history created within that agent will always be private and only accessible to the specific user who created them.
* **The system prompt, selected tools, and sub-agents will be public on workspace-scoped agents.** Users will not be able to modify these fields on the original workspace-scoped agent, but can make changes once they've cloned the agent.
* **The channel type on workspace-scoped agents is public** (for example, Slack message received), but the specific connection with the channel (for example, the Slack channel, or Gmail address) is not shared. This way, users know what channel to use when cloning an agent, but can't gain unauthorized access to any connections the original user has set up.

## Update memory

Your agent can remember information from previous conversations and use it to make better decisions in future conversations. Agents persist memories by writing files to a **memories folder** using `write_file` and `edit_file` tool calls.

By default, your agent requires approval before saving to the memories folder. When this setting is enabled, the agent pauses and waits for you to accept, edit, or reject each memory update in the Fleet UI before continuing.

<Tip>
  If your agent runs on a [schedule](/langsmith/fleet/schedules#add-a-schedule) or other automated schedule, disable the memory approval requirement. Otherwise, the agent will pause on every scheduled run that involves a memory update and wait indefinitely for manual approval.
</Tip>

### Disable required approval for memory updates

To disable the memory approval requirement:

1. In the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-fleet-manage-agent-settings), navigate to your agent's inbox.
2. Next to the agent name, click the <Icon icon="pencil" /> **Edit Agent** icon.
3. In the top right corner, click the <Icon icon="settings" /> **Settings** icon.
4. In the **Memory** section, toggle **Require approval to update memories** to off.

## Use the agent programmatically

You can use the [LangGraph SDK](/langsmith/reference) to connect to your agent through code. To view the code snippets needed to call your agent programmatically:

1. In the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-fleet-manage-agent-settings), navigate to your agent's inbox.
2. Next to the agent name, click the <Icon icon="pencil" /> **Edit Agent** icon.
3. In the top right corner, click the <Icon icon="settings" /> **Settings** icon.
4. Click the **View code snippets** button.
5. Copy the pre-populated code snippets for your agent.

For more information, see [Call agents from code](/langsmith/fleet/code).

## Pause agent

To pause an agent, pause its channels:

1. In the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-fleet-manage-agent-settings), navigate to your agent's inbox.
2. Next to the agent name, click the <Icon icon="pencil" /> **Edit Agent** icon.
3. In the graph view, click the **Pause** button in the **Channels** box.
4. Click **Save Changes**.

<Tip>
  To resume, click the **Resume channels** button in the **Channels** box.
</Tip>

## Delete agent

To permanently delete an agent:

1. In the [LangSmith UI](https://smith.langchain.com?utm_source=docs\&utm_medium=cta\&utm_campaign=langsmith-signup\&utm_content=langsmith-fleet-manage-agent-settings), navigate to your agent's inbox.
2. Next to the agent name, click the <Icon icon="pencil" /> **Edit Agent** icon.
3. In the top right corner, click the <Icon icon="settings" /> **Settings** icon.
4. Click the **Delete Agent** button.
5. To confirm the deletion, click the **Delete** button.

<Warning>
  This action cannot be undone. It will permanently delete the agent, all threads linked to the agent, and unlink any attached channels.
</Warning>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/fleet/manage-agent-settings.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>