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

> ## Agent Instructions
> Cognite Data Fusion (CDF) is an industrial DataOps platform. Prefer English docs unless the user asks for another locale.
> Follow /_llms/ index links recursively until you reach page URLs ending in .md. Fetch those Markdown twins instead of HTML.
> For REST APIs, default to calendar version 20230101 (stable). Use 20230101-beta or 20230101-alpha only if the user is on a preview API. Cite paths under /api-reference/concepts/<version>/ and the Cdf-Version header. Prefer the Python SDK (cognite-sdk) unless the user is in JavaScript/TypeScript.
> Start here by task: platform overview /cdf/index.md; data modeling /cdf/dm/index.md; data integration /cdf/integration/index.md; access /cdf/access/index.md; CDF Toolkit /cdf/deploy/cdf_toolkit/index.md; REST quickstart /dev/quickstart.md; Python SDK https://cognite-sdk-python.readthedocs-hosted.com/en/stable/; Atlas AI /cdf/atlas_ai/index.md; plan an Atlas AI agent /cdf/atlas_ai/concepts/atlas_ai_agent_planning.md; Flows apps /cdf/flows/index.md; MCP and IDE setup /dev/guides/ide_ai_integration.md.
> For implementation work, also load /skill.md.

# Extending the default Atlas agent

> Step-by-step guide for administrators to add instructions, skills, and sub-agents to the default Atlas agent, then test and publish that extension.

> For the complete Cognite documentation index, see [/llms.txt](https://docs.cognite.com/llms.txt). For full page content, see [/llms-full.txt](https://docs.cognite.com/llms-full.txt).

Add a Default Atlas AI extension so the default Atlas agent uses your company's instructions, skills, and specialist agents. Continue to work on the default Atlas agent. The Cognite-managed agent in Cognite Data Fusion (CDF) stays unchanged.

Read [About the default Atlas agent](https://docs.cognite.com/cdf/atlas_ai/concepts/about_default_atlas_agent.md) for what the extension contains and who it affects. This page is how you publish it.

> [!NOTE]
>
> The extension is configured under **Atlas AI** > **Default Agent**. If you do not see **Default Agent**, it is not enabled for your project yet.

## Before you start

You need permission to publish agents in the CDF project, such as **Administer all agents**. See [Capabilities](https://docs.cognite.com/cdf/access/guides/capabilities.md#atlas-ai).

Prepare the pieces you want to attach:

* Instructions that describe local terms, equipment names, or how answers should be framed.
* Skills that already exist in the project catalog. See [About Atlas AI agent skills](https://docs.cognite.com/cdf/atlas_ai/concepts/atlas_ai_agent_skills.md).
* Specialist agents that are already published. Attach published agents only. See [About Atlas AI agent subagents](https://docs.cognite.com/cdf/atlas_ai/concepts/atlas_ai_agent_subagents.md).

Each project has one Default Atlas AI extension. A new tool or a new language model belongs in the [Agent builder](https://docs.cognite.com/cdf/atlas_ai/guides/atlas_ai_agent_building.md).

## Add and publish an extension

Publishing applies the extension to every person who uses the default Atlas agent in the project. Test the draft first. While you test, other people stay on the current published behavior.

**1. Open Default Agent**

In CDF, open **Atlas AI** > **Default Agent**.

This page is separate from the Agent builder. Changes here add to the Cognite-managed agent. Its instructions, tools, and language model stay as Cognite ships them.

**2. Add instructions, skills, and sub-agents**

Add any combination of these:

* Additional instructions for how the default Atlas agent should interpret this project's operations.
* Skills from the project catalog.
* Published agents as sub-agents.

Additional instructions are added to the Cognite-managed agent.

**3. Test the draft**

Open the chat preview on **Default Agent** and ask questions your users ask, including one specialist question if you attached a sub-agent.

The draft applies only in this preview. People using the default Atlas agent in the project are unchanged. If nothing is published yet, they still use the Cognite-managed agent alone.

**4. Publish the extension**

Publish the draft when the preview answers are right.

Everyone on the default Atlas agent in the project then gets the Cognite-managed agent plus this extension. The extension applies only on the default Atlas agent.

Publishing replaces the previously published extension. The Cognite-managed agent stays unchanged.

Confirm the result with a question you tested in the draft, asked as a user of the default Atlas agent outside the preview.

## Restore the Cognite-managed agent

Unpublish the extension to return everyone on the default Atlas agent to the Cognite-managed agent. The draft remains, so you can correct it, test again, and publish when it is ready.

## Related information

* [About the default Atlas agent](https://docs.cognite.com/cdf/atlas_ai/concepts/about_default_atlas_agent.md)
* [About Atlas AI](https://docs.cognite.com/cdf/atlas_ai.md)
* [Build and publish agents](https://docs.cognite.com/cdf/atlas_ai/guides/atlas_ai_agent_building.md)
* [About Atlas AI agent subagents](https://docs.cognite.com/cdf/atlas_ai/concepts/atlas_ai_agent_subagents.md)
