Skip to main content

Ask AI: Conversational Search for Atmos Documentation

· 2 min read
Erik Osterman
Erik Osterman
Founder @ Cloud Posse

Finding information in documentation shouldn't require knowing the exact terminology or page structure. With Ask AI, you can now ask natural language questions about Atmos and get intelligent, contextual answers—powered by Algolia DocSearch v4 and ChatGPT.

How It Works​

When you open the search dialog (press / or Cmd+K), you can seamlessly switch between traditional keyword search and a chat-style assistant that understands your questions.

Key features:

  • Natural language queries - Ask questions like "How do I configure AWS SSO authentication?" or "What's the difference between stacks and components?"
  • Contextual answers - Responses are generated from the actual documentation content, not generic AI knowledge
  • Source citations - Every answer includes links to the specific documentation pages it drew from
  • Seamless experience - Switch between keyword search and AI assistant without leaving the search dialog.

Under the Hood​

Ask AI uses Algolia's integration with large language models (LLMs) to understand your questions and find relevant information from the indexed documentation. The assistant is specifically trained on Atmos documentation, so it understands:

  • Atmos CLI commands and their flags
  • Stack configuration patterns and YAML syntax
  • Authentication providers and identity management
  • Workflows, custom commands, and extensibility patterns
  • Design patterns and best practices

Try It Now​

Visit atmos.tools and press / or Cmd+K to open the search dialog. Try asking questions like:

  • "How do I set up AWS SSO with Atmos?"
  • "What is the difference between imports and inheritance?"
  • "How do I create a custom workflow?"
  • "What YAML functions are available?"

The AI assistant will provide detailed answers with direct links to the relevant documentation pages.

Technical Details​

This feature is enabled by upgrading to Docusaurus 3.9.2 and DocSearch v4, which adds native support for Algolia's Ask AI feature. The assistant is configured with an understanding of Atmos as a DevOps and cloud automation tool, ensuring responses are relevant and technically accurate.

Get Involved​

Have feedback on Ask AI? We'd love to hear how it's helping you navigate the documentation: