search_docs
Search Ansible documentation for conceptual guides by keyword, filtering by source, topic, or audience to retrieve relevant entries with summaries and raw URLs.
Instructions
Search documentation manifests for conceptual guides.
Returns up to 20 matching entries with title, summary, topic, audience, lines, source, and raw URL. On failure returns {"error": str}.
Choose source by corpus:
ansible-core (or omit): official HOWTO — playbooks, vault, inventory syntax
ansible-lint: rules and profiles
ansible-navigator / ansible-builder / ansible-creator / molecule: matching source
aap-2.5 / aap-2.6 / aap-2.7: AAP product manuals
cop-good-practices: CoP opinionated practices (role design, naming, CaC, Git, testing process). Users often say "best practices"; do not invent cop-best-practices. Unfiltered search fills the 20-hit window with official + AAP first; CoP may be absent — retry with source='cop-good-practices' for CoP-shaped questions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search term to match against documentation titles, summaries, and topics | |
| topic | No | Filter by topic tag | |
| source | No | Filter to a single source (e.g. 'cop-good-practices', 'ansible-core', 'aap-2.6'). Good-practices / 'best practices' / GPA questions use source='cop-good-practices'. | |
| audience | No | Filter by audience tag | |
| core_only | No | If true, only return entries marked as core |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |