Powered by Claude
User Guide & Help
v2.3 โ€” Jul-2026
๐Ÿš€

Getting Started

Ask Hirsch is a private AI assistant built for the HirschSecure / Identiv QA team. It understands Velocity, SNIB3, ScramblePad, PACS protocols, readers, and firmware out of the box โ€” no need to explain context.

1

Select an Action

Choose one of the 8 action cards on the welcome screen โ€” this sets the mode for your request.

2

Complete the Quick Setup

A 2-step card appears with relevant options. Select what applies and click Generate. Or click Skip โ†’ to use defaults.

3

Attach Files (Optional)

Click the ๐Ÿ“Ž paperclip to attach log files, specs, screenshots, or a ZIP archive.

4

Type & Send

Describe your task. Specific feature names, error messages, and file names give much better results.

๐Ÿ’ก You can switch actions mid-conversation using the pill bar at the bottom of the chat.
โšก

8 Action Types

Cards appear in two rows of 4 on the welcome screen. Row 1: Test Cases, Requirements, Tech Support, Know Your Product. Row 2: Troubleshoot, Research, Tools, Draft.

Standard Claude Actions

Locked to Sonnet 5.5 (most capable). Model cannot be changed for these actions.

๐Ÿงช

Create Test Cases

Generates Zephyr Scale CSV test cases ready to import into Jira. Covers functional, negative, edge and UI scenarios.

๐Ÿ“‹

Analyse Requirements

Reviews specs, finds gaps, ambiguities, missing conditions, and testability issues.

๐Ÿ”ง

Troubleshoot & Analyse

Analyses log files for errors, root causes, patterns. Can also summarise activity over a time period.

๐Ÿ”

Research Topics

Explains protocols, standards, technologies. Enable Web Search for the latest information.

โš™๏ธ

Develop Tools

Writes PowerShell, Python, Batch scripts and automation tools for QA tasks.

โœ๏ธ

Draft / Ask Anything

Write Jira tickets, reports, emails, summarise content, or ask anything general. Can export as PPTX or DOCX.

RAG-Grounded Actions (Knowledge Base)

Use the knowledge base for accurate, product-specific answers. Web Search and Ecosystem Knowledge toggles are hidden for these โ€” they use KB retrieval, not live web data. Choose Haiku 5.5 (fast) or Sonnet 5.5 (capable) from the topbar. Select your product (Velocity, SNIB3, PACS, Enterphone) from the pill bar.

๐Ÿ› ๏ธ

Tech Support

Troubleshoot technical issues, errors, and configuration problems. Grounded in product documentation. Get diagnosis, resolution steps, and escalation guidance.

๐Ÿ“–

Know Your Product

Learn product architecture, features, behavior, configuration, and test design. Grounded in product documentation. QA-focused on states, edge cases; Dev-focused on components, interfaces.

Frequently Asked

Can I skip the setup card? โ–พ
Yes โ€” click Skip โ†’ to go straight to generation with sensible defaults applied automatically.
What format are test cases exported as? โ–พ
Zephyr Scale CSV format, ready to import directly into Jira. Each table in the response has a Download CSV button that appears automatically.
Can I ask follow-up questions after a response? โ–พ
Yes โ€” type a follow-up and send. Claude keeps the full conversation context. You can ask for more test cases, more detail on a specific error, or to rewrite any section.
Can I switch actions mid-conversation? โ–พ
Yes โ€” click any action in the pill bar below the input box to switch. For example, start with Troubleshoot to analyse a log, then switch to Create Test Cases to generate tests from the findings.
๐Ÿ“Ž

Attaching Files

How to attach

Click the paperclip icon in the input box. Hold Ctrl (or Cmd on Mac) to select multiple files. Use + Add more to add more files after already attaching some.

File Badges

Each file appears as a badge showing name and size:

๐Ÿ“ HCSDebug_20260408.txt  81.4 KB ร— ๐Ÿ“ DTService.txt  3.4 MB โšก ร— ๐Ÿ—œ๏ธ logs.zip  2.9 MB ร—

Files over 120 KB show an โšก amber warning โ€” automatically truncated (head + tail) before sending.

โš ๏ธ Maximum: 50 MB per file. Very large files (4โ€“7 MB) are still analysed โ€” just truncated to fit Claude's context window.
What happens to very large files? โ–พ
Files over 120 KB are truncated: first 90 KB + last 30 KB are kept. This captures both file headers/config and the most recent errors at the tail.
Can I remove a file after attaching? โ–พ
Yes โ€” click ร— on the badge to remove a specific file, or use Clear all to start over.
๐Ÿ—œ๏ธ

ZIP Archives

Zip 40+ log files into a single .zip and attach it as one file. Ask Hirsch automatically extracts all text and log files inside the ZIP and sends each to Claude separately for full cross-file analysis.

1

Create the ZIP

In Windows Explorer, select all .txt / .log files โ†’ Right click โ†’ "Compress to ZIP file"

2

Attach the ZIP

Click the paperclip. The badge shows ๐Ÿ—œ๏ธ logs.zip ร— and the notice says "ZIP archive โ€” files extracted automatically"

3

Send normally

Backend extracts all files. Claude receives each one separately and correlates errors across all files.

๐Ÿ’ก ZIP is the recommended way to send 10+ log files. It bypasses the batch limit and sends everything in one request.
Which file types are extracted from ZIP? โ–พ
All text-readable files: TXT, LOG, CSV, JSON, INI, CFG, CONF, XML, YAML, YML, HTM, HTML, MD, BAT, PS1, PY, JS, TS, CS, JAVA, SQL, TOML, ENV, PROPERTIES. Binary files (images, executables) are skipped.
๐Ÿง 

Model Selection (RAG Actions Only)

For Tech Support and Know Your Product actions, choose your model from the topbar:

๐Ÿง  Haiku 5.5 โ€” Fast & economical, default. Best for routine questions and quick lookups.

Responses are usually instant. Great for cost optimization when quality isn't critical.

๐Ÿง  Sonnet 5.5 โ€” Most capable

Use for complex troubleshooting, detailed architecture questions, or when you need the highest quality. Slightly slower than Haiku.

๐Ÿ’ก Old cards (Test Cases, Requirements, etc.) are locked to Sonnet 5.5 for quality. Model selector is disabled for those actions.
๐Ÿ“ฑ

Product Selection (RAG Actions Only)

For Tech Support and Know Your Product actions, select which product you're asking about from the pill bar below the input:

๐Ÿ“ฑ Product: [Velocity โ–ผ] โ€” Choose: Velocity (default), SNIB3, PACS, or Enterphone

Your selection narrows the knowledge base retrieval to that product's documentation, ensuring accurate, product-specific answers.

๐Ÿ’ก Not sure which product? Start with Velocity โ€” the most common. You can switch products mid-conversation.
๐Ÿ”˜

Web Search & Domain Knowledge

Two toggle switches sit in the footer below the input box, on the right side. These are automatically hidden when a RAG action (Tech Support / Know Your Product) is selected โ€” those actions use the knowledge base instead.

๐ŸŒ Web Search โ€” search the internet for current information
OFF default

When enabled, Claude can search the internet for latest standards, software versions, release notes, or news. Best for Research Topics. Requires confirmation โ€” uses significantly more tokens.

๐Ÿข Domain Knowledge โ€” use PACS / Hirsch / Velocity expertise
ON default

When enabled (the default), Claude applies its full HirschSecure / Identiv / Velocity domain expertise. Turn OFF only if you need generic AI answers. A confirmation popup appears before turning off.

โš ๏ธ Turning Domain Knowledge OFF significantly reduces quality for PACS-related questions. Keep it ON for all normal usage.
๐Ÿ”ง

Maintenance Mode (Admin Only)

Admins can toggle maintenance mode from the admin settings panel. When enabled, non-admin users see a maintenance page instead of the chat interface.

How it works

1

Admin toggles in settings

Open the admin dashboard โ†’ Settings panel โ†’ toggle Maintenance Mode. No restart required.

2

Non-admins blocked immediately

Users are shown a maintenance notice. They cannot access chat until the flag is disabled.

3

Admins retain full access

Admins can still use chat and the dashboard while maintenance mode is active.

๐Ÿ’ก Use this when updating the RAG knowledge base, deploying changes, or performing system maintenance without downtime messaging to users.
๐Ÿ“ฆ

Large File Batching

When you attach more than 8 files or files totalling over 600 KB, Ask Hirsch splits them into batches. Each batch is sent separately to stay within Claude's token limit.

1

Batch 1 sends automatically

First batch (up to 8 files / 600 KB) sends with your message. Claude analyses and responds.

2

Continue button appears

"โšก Batch 1 of 4 complete โ€” [Continue โ†’ (8 more files)] [โœ• Stop]"

3

Click Continue at your pace

Read each response, click Continue when ready. Claude builds on its previous findings.

๐Ÿ’ก Use a ZIP archive to bypass batching entirely โ€” all files in the ZIP go in one request.
โน

Stopping a Response

Stop button

While Claude is generating, the Send button is replaced by a red โน Stop button. Click it to immediately cancel. The partial response is preserved โ€” you can follow up or refine your question.

๐Ÿ“š

Chat History & Session Persistence

Background streaming

You can switch to another chat while a response is generating. The response continues in the background โ€” when you return, the completed response is there.

Session appears immediately

As soon as you click Send, the chat is saved to your history โ€” before Claude even responds. You can navigate away and come back any time.

Search & Delete

Use the search box at the top of the sidebar to find past conversations. Hover over a chat and click ร— to delete.

Floating query bar

Your most recent question stays visible at the top of the chat area while Claude's response streams in. This keeps your original query in view so you can reference it while reading the response.

History notice

Admins can display an optional notice banner in the chat history sidebar (e.g., maintenance alerts, policy reminders). Toggled via admin settings.

๐Ÿ’ก Your session persists after page refresh โ€” no need to log in again unless you explicitly sign out.
๐Ÿ’ก

Tips & Best Practices

Be specific

"Write test cases for SNIB3 firmware upgrade via Velocity" is much better than "write test cases".

Attach the raw log file

Don't describe what the log says โ€” attach the file. Claude reads raw log content far better than a paraphrase.

ZIP for bulk analysis

Zip all debug files from a session and ask "Find all errors and correlate across files" for full cross-file root cause analysis.

Use Summarise for activity reports

In Troubleshoot & Analyse, choose "Summarise what happened" to get a timeline report instead of error analysis.

Follow up to refine

After a response, ask "Add 5 more edge cases" or "Rewrite TC_003 with more negative scenarios" โ€” Claude keeps full context.

Skip setup when you know what you want

Click Skip โ†’ on the pretask card to go straight to generation with defaults.

๐Ÿ“„

Supported File Formats

๐Ÿ“„ DocumentsPDF, HTML, HTM, MD
๐Ÿ–ผ๏ธ ImagesPNG, JPG, JPEG, GIF, WebP
๐Ÿชต Logs & TextTXT, LOG, CSV
โš™๏ธ ConfigINI, CFG, CONF, CONFIG, TOML, ENV, PROPERTIES, YAML, YML
๐Ÿ“Š DataJSON, XML
๐Ÿ ScriptsPY, PS1, BAT, JS, TS, CS, JAVA, SQL
๐Ÿ—œ๏ธ ArchivesZIP (auto-extracted)
๐Ÿ’ก Table responses include a Download CSV button. Script responses include a file download button.
๐Ÿ”„

Changelog

v2.3Code refactoring & robustness โ€” Improved code structure for better maintainability and readability. Enhanced admin endpoint โ€” `/api/admin/summary` now includes all users (not just pagination results). Floating query bar โ€” last user query stays visible above the chat area while the response streams in. Backup deletion & document indexing โ€” new cleanup utilities and improved parent context tracking. Maintenance mode & history notice โ€” admin-controlled toggle to show maintenance page to non-admin users, optional notice banner in chat history area.
v2.2Admin dashboard enhancements โ€” User search filter (search by username or email, real-time), User role editor (change any user's role User โ†” Admin via dropdown in search results), All-time usage filters (filter by user and date range with year/month pickers), Per-user budget search (quick search to find specific user budgets).
v2.1Admin dashboard polish โ€” 7-tab admin interface with billing/budget tiles, per-user cost tracking, bulk user import. Enhanced login โ€” last username remembered, password field auto-focused, role-based landing (users โ†’ chat, admins โ†’ last-viewed tab). View persistence โ€” admin tabs and view restored on refresh. 4ร—2 action grid โ€” 8 actions in two balanced rows. Toggle auto-hide โ€” Web Search & Domain Knowledge toggles hidden for RAG actions. SQLite foundation โ€” all data stores in SQLite WAL; legacy JSON backed up as .bak. Login security โ€” 3-attempt lockout, single active session per user.
v2.0RAG integration launch โ€” 2 knowledge-base grounded actions (Tech Support, Know Your Product). Multi-model (Haiku 4.5 / Sonnet 4.6) for RAG only. Product selection (Velocity, SNIB3, PACS, Enterphone). Old actions locked to Sonnet 4.6. Admin dashboard (7 tabs), role system, login lockout, single sign-in.
v1.30Background streaming โ€” switch chats during response without losing it. Session appears in sidebar immediately on Send. Web Search + Domain Knowledge toggles. Stop button. ZIP auto-extraction. Interactive help page with changelog.
v1.29Continue button for multi-batch file sending โ€” no more page freeze. fmtStream() lightweight renderer during streaming. 250ms render throttle.
v1.28ZIP archive support โ€” attach one ZIP instead of 40 individual files. Backend extracts and sends each file separately.
v1.27File handling overhaul โ€” synchronous badge loading, large file warnings, batch size calculation fixes.
v1.26User bubble plain text fix. QA prompt display race condition fixed. Domain knowledge backend wiring.
v1.25Multi-file batch sending, progress bar, file type icons, amber large-file warnings.
v1.20Ask Hirsch branding, welcome screen redesign, dark/light theme toggle.
v1.106 action cards, pretask interrogation, Zephyr CSV export, PPTX/DOCX export.
v1.00Initial release โ€” streaming chat, session history, admin dashboard, user budgets.