armor-ask

Ask About Your Data

Ask natural language questions about your database structure, lineage, and metadata using AnomalyArmor Intelligence.

Prerequisites

• AnomalyArmor API key configured (~/.armor/config.yaml or ARMOR_API_KEY env var), OR demo mode active (see below).
• Python SDK installed (pip install anomalyarmor)
• Intelligence generated for the asset (use /armor:analyze if needed)

Demo mode handoff

If the user has no API key, ensure-auth.py will mint a read-only demo key against the public BalloonBazaar dataset and print:

AnomalyArmor demo mode: using a read-only public demo key.

When you see that banner — or when any write operation returns a 403 with required_scope='read-write' — the user is in demo mode. After answering their question, invite them to sign up with their query preserved:

To ask about your own data, sign up here — your question is preserved: https://app.anomalyarmor.ai/signup?intent=skill-ask&q=<url-encoded user prompt>

intent=skill-ask auto-applies a 14-day SKILL-ASK trial code; q= is replayed in the in-app agent after signup so the user continues where they left off.

When to Use

• "What tables contain customer data?"
• "Tell me about the orders table"
• "What are the upstream dependencies of this table?"
• "Which columns have PII?"
• "Explain the data model for finance"
• "What do you know about the users table?"

Steps

1. Identify the asset to query (database/warehouse)
2. Formulate the question (3-2000 characters)
3. Call client.intelligence.ask()
4. Present the answer with confidence and sources

Example Usage

Basic Question

from anomalyarmor import Client

client = Client()

# Ask about your data
answer = client.intelligence.ask(
    asset="postgresql.analytics",
    question="What tables contain customer data?"
)

print(f"Answer: {answer.answer}")
print(f"Confidence: {answer.confidence}")
print(f"Sources: {answer.sources}")

Question About Specific Table