Usage

Tools

A complete list of all built-in tools the CoPilot agent can use to manage your content.

Tools are the actions the agent performs on your behalf. When you ask the agent to do something like "create a blog post" or "translate this entry" it uses one or more tools behind the scenes. You can see which tools are being called in the chat as they execute.

CoPilot tools in action

Discovery & Schema

These tools help the agent understand your content structure before making changes.

Tool	Description
listSections	Lists all sections the current user can access, with entry type handles.
listSites	Lists all configured sites with their handles, names, and languages.
describeSection	Returns field definitions, value formats, and hints for a section. Called before creating or updating entries.
describeEntryType	Returns full field definitions for a specific entry type or Matrix block type.
describeCategoryGroup	Returns field definitions for a category group.
describeVolume	Returns field definitions for an asset volume.

Search

Search tools let the agent find existing content. They return summaries with IDs that can be used in create or update operations.

Tool	Description
searchEntries	Searches or lists entries in allowed sections. Can filter by section, status, author, and site.
searchAssets	Searches for assets (images, files) across allowed volumes.
searchCategories	Searches for categories by title.
searchTags	Searches for tags by title.
searchUsers	Searches for users by name or email.
searchFormieForms	Searches Formie forms by title. Returns form handles. Only available when Formie is installed.

Read

Read tools retrieve detailed information about specific content.

Tool	Description
readEntry	Reads a single entry. Summary mode shows metadata and which fields are filled. Full mode returns complete field values.
readEntries	Batch-reads multiple entries by ID. Use instead of reading entries one by one.
readAsset	Reads asset metadata and URL.

Create

Tool	Description
createEntry	Creates a new entry in a section. Save behavior depends on your configuration.
createCategory	Creates a new category in a category group.

Update

Tool	Description
updateEntry	Updates one or more fields of an existing entry in a single save. Save behavior depends on your configuration.
updateAsset	Updates asset metadata like title, alt text, and custom fields.
updateCategory	Updates an existing category's title, slug, and custom fields.
publishEntry	Publishes an entry by enabling it and saving directly. Only used when explicitly asked to publish or go live.

How Tools Work Together

The agent typically follows this workflow when making content changes:

Discover: listSections to find the right section
Describe: describeSection to learn the field structure
Search/Read: searchEntries or readEntry to find or inspect existing content
Write: createEntry or updateEntry to make changes
Verify: readEntry to confirm the changes were applied correctly

Note

All tools respect the access control settings. If a section is set to read-only, the agent can read but not modify entries in that section.

Custom Tools

Developers can extend the agent with custom tools to add new capabilities. See the Custom Tools guide for a full walkthrough.

Brand Voice

Define your brands tone, terminology, and writing rules so the AI stays on-brand.

Permissions

Understand how CoPilot permissions work together with Craft user permissions to control access.

Useful links