Skip to main content

Databook Coach Editor Guide

Complete Walkthrough of the Databook Coach Editor

Written by Priti Shukla
Updated this week

Part 1: How the Coach Editor Works

The Cloning Model

The Coach Editor is built around a clone and edit workflow. Databook provides base coaches — pre-built, verified agents that have been tested end-to-end for specific sales motions (e.g., prospecting, opportunity sizing). Rather than building a coach from scratch, you clone a base coach and customize it to fit your organization's needs.

Here's what that means in practice:

  1. Clone a base coach — this creates your own editable copy.

  2. Edit at your own pace — the original base coach remains live and available to your team while you work on the customized version. There's no rush.

  3. Publish when ready — once you're satisfied with your changes, set the custom version live. It replaces the base coach for your organization.

This approach gives you the freedom to experiment without disrupting anything that's already working.


Part 2: Anatomy of a Coach

When you open a cloned coach in the editor, you'll see several sections. Some are editable, some are locked. Here's what each one does.

Name (Editable)

The display name of the coach. Rename it to something that reflects the customizations you've made — for example, changing "Prospecting Sequence Coach" to "Enterprise Prospecting Coach" if you've tailored it for enterprise accounts.

Description (Editable)

The user-facing description that appears when someone views the coach. Update this to describe what your customized version does, so your team understands what they're getting when they launch it.

Trigger: Manual (Locked)

The trigger field is set to Manual and is locked. This means the coach starts when a user clicks the button to launch it — it doesn't run on its own.

In the future, coaches will support automated triggers such as:

  • A CRM stage change (if your organization has a CRM integration with Databook)

  • A time-based schedule (e.g., quarterly)

  • An external event (e.g., an earnings call is released, a Databook score changes)

Automated coaches will be able to run research, generate output, and push results to systems like your CRM, Slack, or email — without the user initiating anything. That capability is on the roadmap but not available today. For now, all coaches are manually triggered.

Type: Sequential (Locked)

The type field is set to Sequential and is locked. This means the coach moves through its tasks in a defined order — one step at a time, from start to finish. The user progresses through the flow linearly.

Purpose (Locked)

The purpose field describes what the coach is designed to do at a fundamental level. This field is locked intentionally.

The clone-and-edit model is designed to let you customize a verified use case — one that's been built and tested to work end-to-end. Changing the purpose would fundamentally change what the agent is trying to accomplish, which defeats the benefit of starting from a proven foundation. The goal is to tailor how the coach executes its purpose, not to redefine the purpose itself.

Tasks (Editable)

Tasks are the core of the coach. Think of them as the steps the coach follows to get from start to finish. For example, a prospecting coach might have tasks like:

  1. Identify the target account — Confirm which company the user wants to prospect into.

  2. Research signals — Look up external signals (earnings calls, leadership changes, hiring trends) that could be relevant for outreach.

  3. Select a contact — Identify the right person to target based on persona and role.

  4. Generate the sequence — Produce the actual outreach (emails, LinkedIn messages, call context).

Each task has its own anatomy, covered in the next section.

Output (Editable)

The output section controls what the final deliverable looks like. Right now, output is limited to text (e.g., email copy, research briefs, call prep notes). Future formats will include PDFs and PowerPoints.

Within the output section, you can manage:

  • Tone — How the output should read (e.g., professional but conversational, direct, executive-level)

  • Format — The structure of the output (e.g., bullet points, numbered lists, headers, sections)

  • Examples — Sample outputs that show the AI what "good" looks like (e.g., a well-written prospecting email your team has used successfully)

The output section is where many teams will want to make edits to match their organization's brand, voice, and outreach style.


Part 3: Task Anatomy

Each task inside a coach has four components.

Title

A short label that describes what the task does at a high level (e.g., "Company research and signal detection"). This is what you see when scanning the task list in the editor. You can rename it to anything that makes sense for your team.

Description

An auto-generated summary based on the title and instructions. It gives a more detailed explanation of what the task does, so someone reviewing the coach in the editor can quickly understand the flow without reading the full instructions.

Instructions

This is where the prompt engineering happens — the heart of each task. The instructions tell the coach:

  • What its purpose is for this specific step

  • What it should do — the actions, research, or analysis to perform

  • What the outcomes should be — what gets produced or confirmed before moving to the next step

A good way to think about writing instructions is to follow a logical business flow. For example, a "Target Account" task might work like this:

The purpose of this task is to correctly identify the target company. After resolving the company, confirm with the user that this is the account they intended — since many companies share similar names across the Databook database and web search results.

That's a simple, clear instruction set. You're defining the job (identify the account), the action (look it up and resolve it), and the outcome (confirm with the user before moving on).

Tools

Tools define the scope of information available to a task. They control what data sources and capabilities the coach can access when executing that step.

Some common tools you'll see:

Tool

What It Does

Company Linker

Looks up the company in the Databook database

Use Cases Query

Pulls use cases from your organization's configuration

People Query

Finds buying contacts at the target company

Web Search

Searches the web for recent news and public information

News Search

Searches for recent news articles about a company or person

Get Executive

Retrieves executive-level contact information

You'll see how tools are referenced within the instructions of each task. The instructions tell the coach when and how to use a given tool. Don't worry about tools too much when getting started — the biggest gains come from editing the instructions themselves, not from changing the tool list.


Part 4: What You Can Edit

Here's a summary of what's available to change and what's locked.

Field

Editable

Notes

Name

Yes

Rename to reflect your customizations

Description

Yes

Update to describe your custom version

Trigger

No

Locked to Manual for now

Type

No

Locked to Sequential for now

Purpose

No

Locked to protect the verified use case

Task titles

Yes

Rename tasks to fit your terminology

Task instructions

Yes

Edit, expand, or refine the prompts

Task tools

Yes

Add or remove tools from a task

Tasks themselves

Yes

Edit existing, delete, or add new tasks

Output

Yes

Modify tone, format, structure, and examples

Recommended Starting Points

Edit existing task instructions — This is the highest-value, lowest-risk change. You're refining what a task does without changing the overall flow. Even small prompt additions can produce meaningful differences in the output.

Edit the output section — If your organization has a specific brand voice, email style, or messaging framework, this is where you encode it. Add examples of what great outreach looks like for your team.

Add new tasks — This is more advanced and adds complexity, but it's fully supported. A new task can leverage all the research and context from previous steps without re-doing any work.


Part 5: Key Features

History

Every time you save changes, a version is recorded. If an edit doesn't work out, you can:

  • Open the History panel

  • Browse previous versions

  • Expand any version to see what was different

  • Restore a previous version that you know worked correctly

This is your safety net. Edit freely knowing you can always roll back.

Preview

The Preview function lets you test the coach as a user would experience it. After making changes in the editor:

  1. Click the Preview button.

  2. Walk through the flow from the user's perspective.

  3. See how your changes affect the actual output.

Use this after every meaningful edit to verify the flow still works the way you expect.

Set Live

When you're ready to publish your customized coach:

  1. Click Update and Set Live (or Set Live).

  2. Databook runs an automated evaluation to test the coach end-to-end. You'll see a notice that the system is checking and validating the flow.

  3. If the coach passes, you'll receive a notification and it goes live automatically for your entire organization.

  4. If the coach does not pass, you'll receive a notification with an error message explaining what went wrong. You can then fix the issue and try again — or, if the error seems minor or like a one-time blip, you can override and deploy anyway.

When a custom coach goes live, the base coach is hidden and your customized version becomes the one your team sees and uses.


Part 6: Guardrails

The Coach Editor has several built-in safeguards to keep things running smoothly.

Security Validation on Save

Every time you edit a task's instructions and save, the content is run through a security validator. This checks for:

  • Prompt injection attempts

  • Inappropriate or non-business instructions

  • Content that could cause the agent to behave unexpectedly

This happens automatically — you don't need to do anything. If the validator flags an issue, you'll be notified before the save completes.

End-to-End Evaluation on Publish

When you set a coach live, the system runs a full evaluation to make sure the coach works from start to finish. This catches issues like broken task transitions, tool failures, or prompts that produce unusable output.

Override Option

If the evaluation returns an error but you believe the coach is still functional (e.g., the error was a transient issue or a non-critical edge case), you have the option to override and publish anyway. Use this with judgment — it's there for flexibility, not as a default.

Version History

As covered above, every saved version is preserved. If a published coach has issues, you can restore a previous version at any time.


Part 7: Editing Tips

Think in Business Logic First

Before touching the instructions, think about what you want the task to accomplish from a business perspective. What should the seller walk away with after this step? Once you know the answer, the prompt writes itself.

Small Changes, Big Impact

You don't need to rewrite entire tasks. Adding 3-4 lines to an existing instruction set — like asking the coach to include competitive context in its research output — can produce a whole new section in the deliverable.

Use the Preview Loop

The most effective editing workflow is: edit → save → preview → adjust. Make a change, test it, see what happens, and refine. The preview function is there to be used frequently.

Match Your Organization's Voice in the Output Section

The output section is where you'll likely get the most immediate value. If your team has a specific way they write emails, structure LinkedIn messages, or frame value propositions — put examples in the output section. The AI performs significantly better when it has concrete examples of what "good" looks like for your organization.

Don't Change Everything at Once

Make one change at a time and preview it. This makes it easy to identify what's working and what isn't. If you change five things at once and something breaks, it's harder to pinpoint the cause — though you can always restore from history if needed.


Quick Reference

Feature

What It Does

Clone

Create an editable copy of a base coach

Tasks

The steps the coach follows — each with a title, description, instructions, and tools

Instructions

The prompt engineering layer — tells the coach what to do in each task

Tools

Data sources and capabilities available to a task

Output

Controls tone, format, structure, and examples for the final deliverable

History

Browse and restore previous versions of your coach

Preview

Test the coach as a user would experience it

Set Live

Publish your custom coach to the organization (replaces the base version)

Security Validator

Automatic check on every task save for prompt safety

Evaluation

Automatic end-to-end test when publishing

Override

Option to publish even if the evaluation flags a non-critical issue

Did this answer your question?