Skip to main content
Community Hub
TL;DR

Learn how agent templates connect Atlan to your knowledge sources over MCP and turn what's written there into governed context, one outcome per template.

Your AI can read this via Docs MCPcurl -fsSL "https://docs.atlan.com/install-docs-mcp" | bashConnect

Understand agent templates Private Preview

Agent templates connect Atlan to the systems where your knowledge already lives, over MCP, and turn what's written there into governed context in your context layer.

Each template is built for one outcome. You pick the template for the outcome you want, connect the sources it needs to read, describe what you are after, and the agent does that job repeatedly and consistently, citing its source every time.

Two outcomes are available today: business graph term creation and enrichment, and linking glossary terms to the assets that implement them. They're the first outcomes, not the boundary of the capability: the same pattern applies to any outcome that enriches the context layer, and further templates are being built. What changes between templates is the outcome and the skills packaged to achieve it. What stays the same is the shape: connect a source, scope it, say what you want, preview, then run.

info

Agent templates are distinct from collection enrichment. Context agents enrich assets you already have in Atlan, working from query history and lineage inside the platform. Agent templates reach outside Atlan, read the documentation your teams write, and create context from it.

Why templates rather than prompts​

A single generic agent produces generic output. Building a bespoke agent for every team requires skills most teams don't have and nobody wants to maintain.

A template sits between the two, and it's more than a prompt with a form around it. Atlan packages the prompt together with the skills that make a run reliable, the quality gates a run must pass, and the write path into Atlan.

Skills are what make runs reliable​

A skill is a reusable, named capability that tells an agent how to perform a task: the business logic to follow, the steps to take, and the edge cases to call out. Skills are first-class assets in Atlan, so they're versioned and one skill can serve many agents.

Every template ships with a set of platform skills, bound in a deliberate reading order, covering the parts of the job that are easiest to get wrong:

  • Reading a source well. How to search a repository or a space, and how to tell a page worth extracting from one that is not.
  • Checking what already exists. Before creating anything, the agent queries Atlan itself through Atlan's MCP server to find what your glossary already holds. A candidate that matches an existing term enriches it rather than creating a duplicate, and a definition a person wrote is left alone.
  • Extracting with evidence. Producing a definition together with the citation that supports it, rather than a plausible sentence with no source.
  • Passing the quality gates. A run is graded before it publishes. Every term needs a citation, duplicates within a run are rejected, and content a person authored isn't replaced.
  • Writing into Atlan correctly. Creating the glossary, categories, terms, and READMEs in the right order, with the right attributes.

Platform skills are always bound and can't be removed. That's what keeps output consistent across every agent built from the same template, and it's the difference between an agent that works on your first attempt and a prompt you have to tune for a week.

You can add your own skills on top, for house rules a template can't know. See Create an agent from a template.

What you supply​

Four things, and none of them is the prompt:

  • What to read: a source and the scope inside it, or, for Asset ↔ Term Linker, the glossaries and asset collection in Atlan
  • The run instructions saying what you want back
  • Optionally, your own skills for conventions specific to your organization

What you can create today​

TemplateWhat it readsWhat it writes
Business Graph Term GeneratorYour docs, through a connected knowledge sourceBusiness graph terms and categories in a glossary named after the agent
Asset ↔ Term LinkerYour glossaries and an asset collection in AtlanLinks from existing terms to the tables, views, and columns that implement them

The picker may also show templates marked Coming soon, which can't be used yet. Selecting the bell on a template card records your interest, and that signal decides which pipeline is built next.

If the outcome you want isn't in the catalogue at all, use Looking for another agent? Tell us what you need at the foot of the picker and describe it in your own words. That reaches the Atlan team directly.

What Business Graph Term Generator does​

The agent works additively. Across a run it:

  • Create a term for each business concept it finds
  • Enrich an existing term that has no definition
  • Attach a citation to every term, so you can trace where a definition came from
  • Leave definitions a person wrote in place, enriching only what's empty
info

Agents are instructed and gated not to replace a definition, term link, or README authored by a person. They fill what's empty and refresh only content they generated themselves. Every value an agent writes is tagged isAIGenerated, so you can audit exactly what an agent has touched.

What runs write, and where​

Every run publishes into a single business glossary named after your agent. Re-runs accrue into that same glossary rather than creating a new one, which is what makes a scheduled agent useful over time.

A run creates:

  • One glossary, named after the agent
  • Categories, to group the terms it finds
  • Terms, anchored to the glossary and assigned to a category
  • READMEs on the glossary and its categories
  • Source links on each term, so anyone viewing the term can open the source its definition came from

Source links appear in the term's Readme & Resources section. A source with a web address, such as a GitHub file or a Confluence page, is attached as a link. A knowledge file is attached as a linked knowledge file. A source with no web address is skipped. A source link that can't be attached never fails a run.

Terms are published live and tagged isAIGenerated, so you can find and review everything an agent has written anywhere in Atlan. Review happens in Atlan's normal glossary flow.

warning

Because your agent's name becomes the glossary name, and the name can't be changed after creation, choose it deliberately. See Create an agent from a template.

What Asset ↔ Term Linker does​

The agent links what already exists. Across a run it:

  • Pairs each verified term in your glossaries with the tables, views, and columns in your collection that can implement it
  • Links a term straight away when its README or custom metadata names the asset, and has a decision model judge the rest
  • Blocks pairs that differ in unit, currency, period, scenario, or comparison, and sends uncertain ones to review
  • Never creates a term, edits a definition, or removes or replaces a link

Links are written only when you publish a sample you've reviewed. See Understand Asset ↔ Term Linker.

How agent reads your sources​

Asset ↔ Term Linker is the exception: it reads your glossary and an asset collection inside Atlan, so it needs no knowledge source. Every other template reads through a knowledge source that an admin connects once, in Settings. The connection holds a read-only credential you provide, and that credential is the access boundary: the agent can read exactly what the token can read, and nothing more.

No end user is asked to sign in to a source, and the connection can't write back to it.

See Knowledge sources for the sources you can connect and how to set each one up.

Sample runs and full runs​

Every agent supports two kinds of run.

A sample run reads a small part of your sources and proposes a handful of terms so you can judge quality in a minute or two. It publishes nothing to Atlan.

A full run does the work properly and publishes to your glossary.

The intended loop is to sample, read what comes back, adjust your instructions, sample again, and only then run in full. A sample run is a quality signal about your instructions, not a shortlist of terms to approve. A full run re-derives everything from scratch.

Asset ↔ Term Linker works differently. Its sample run decides every pair, and publishing writes exactly the links that sample listed, without deciding again. What you review is what gets written.

Need help​

If you need assistance after reviewing this page, contact Atlan support.

See also​