get_improvement_guide

Returns the Ada Entity Improvement Guide — a static reference describing Ada entity types (articles, coaching, playbooks, actions, custom instructions, company description) and best practices for making improvement suggestions.

Call this before proposing changes with propose_change so the assistant chooses the right entity type and follows Ada’s recommended improvement workflow.

Example prompts

  • “What types of Ada entities can I use to improve my Agent?”
  • “Before we make changes, pull up the improvement guide.”
  • “What’s the recommended way to fix a knowledge gap vs. a behavior issue?”

Parameters

This tool takes no parameters.

Response

Returns markdown covering:

  • Entity types — when to use articles, coaching, playbooks, actions, custom instructions, and company description.
  • Making good improvements — recommended workflow, guidelines, and example suggestion formats.
  • Search-first guidance — use search_knowledge and search_coaching before creating duplicates.

The guide recommends prioritizing knowledge articles and playbooks over coaching when addressing root causes. Coaching is best for targeted behavior guidance, not as a substitute for missing knowledge or unstructured workflows.