For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Login
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
  • Introduction
    • Overview
    • Getting started
    • Authentication
    • Data privacy
    • Built-in prompts
    • FAQ
    • Troubleshooting
  • Tools
    • Overview
    • get_ada_configuration
    • get_ada_metric
    • get_available_filters
    • get_conversations
    • get_conversation
    • search_knowledge
    • search_coaching
    • get_improvement_guide
    • list_entities
    • propose_change
    • get_test_cases
    • get_test_runs
    • get_test_run_quota
    • send_feedback
  • Prompt library
    • Overview
    • Improvement recommendations
    • Quick health checks
    • Create visualizations
    • Diagnose performance issues
    • Identify optimization opportunities
    • Review configuration
    • Search knowledge and coaching
    • Test agent responses
    • Deep-dive analysis
Login
LogoLogo
On this page
  • Example prompts
  • Parameters
  • Response
Tools

get_improvement_guide

Was this page helpful?
Previous

list_entities

Next
Built with

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.