Skip to main content

AI Assistant

The AI Assistant provides real-time, context-aware help throughout your requirements engineering workflow. Available directly within requirement details, the AI Assistant understands your project context and can answer questions, provide suggestions, and help clarify requirements.

⚠️ Important: The AI Assistant is Advisory Only (Non-Actionable)

The AI Assistant is a read-only information and analysis tool. It provides suggestions, answers questions, and analyzes your requirements, but it does NOT make changes to your project.

What it DOES: Answers questions, provides suggestions, analyzes quality, cites documents What it DOESN'T DO: Edit requirements, create test cases, or modify any project data

To apply AI Assistant suggestions: Copy them manually or use Requirements Assist (separate actionable features)

Overview​

The AI Assistant appears as a floating chat panel on the right side of requirement detail pages, providing intelligent assistance while you work. It has access to:

  • Current requirement details and history
  • Project documentation and context
  • Associated test cases and architecture
  • Industry best practices and standards
  • Your project's document attachments

Accessing the AI Assistant​

The AI Assistant is accessible from the requirement details view:

  1. Navigate to any requirement in your project
  2. Click the AI chat icon in the bottom-right corner (or press Ctrl/Cmd + K)
  3. The chat panel slides open on the right side, ready for your questions

The AI Assistant remains available as you navigate between requirements, maintaining conversation context when appropriate.

AI Assistant providing intelligent requirement analysis in a sliding panel

Chat Panel Features​

The chat interface includes:

  • Persistent History: Your conversation continues as you work
  • Context Awareness: Automatically knows which requirement you're viewing
  • Rich Responses: Formatted text with bullet points and code examples
  • Document Citations: References to attached specifications with page numbers
  • Copy to Clipboard: Easy copying of AI suggestions for manual application
  • Advisory Output Only: AI Assistant provides information and suggestions but does not make changes

Important: The AI Assistant is read-only and advisory. It analyzes and suggests but does not modify your requirements, test cases, or project data.

Key Features​

Context-Aware Responses​

The AI Assistant automatically understands:

  • Current Requirement: The requirement you're viewing
  • Requirement Version: Specific version details and history
  • Project Context: Your project's domain and standards
  • Document Library: Attached specifications and references

Intelligent Assistance​

Ask the AI Assistant to:

  • Explain Requirements: "Explain this requirement in simpler terms"
  • Suggest Improvements: "How can I make this requirement more testable?"
  • Identify Issues: "Does this requirement have any ambiguities?"
  • Recommend Tests: "What test cases would validate this requirement?"
  • Check Compliance: "Does this meet ISO 26262 standards?"
  • Analyze Quality: "Rate the quality of this requirement"

Conversation Features​

Natural Language Interaction Simply type questions in plain English. The AI understands context and intent:

  • "What specifications does this requirement reference?"
  • "Show me similar requirements in this project"
  • "Break this down into system-level requirements"

Advisory Role (Non-Actionable) The AI Assistant is an advisory and analysis tool that:

  • ✅ Provides suggestions and recommendations
  • ✅ Analyzes requirements for quality and completeness
  • ✅ Answers questions about your requirements and documents
  • ✅ Explains complex specifications in simpler terms
  • ✅ Identifies potential issues or gaps
  • ❌ Does NOT directly edit or modify requirements
  • ❌ Does NOT create test cases automatically
  • ❌ Does NOT make changes to your project

You must take the suggestions and apply them manually using other Pidima features:

  • AI Assistant suggests → You copy the suggestion
  • You manually edit the requirement
  • Or use Requirements Assist features to apply changes

Persistent History Your conversation history is maintained during your session, allowing you to:

  • Reference previous questions and answers
  • Build on earlier discussions
  • Return to the conversation later
  • Copy AI suggestions to use elsewhere

Common Use Cases​

Requirement Clarification​

When reviewing complex requirements:

You: "Explain this requirement SYSTEM-REQ-00003"
AI: "This requirement specifies battery verification criteria including:
     1. Voltage specifications (12.0V ±0.6V)
     2. Physical group size compliance with BCI standards
     3. Cold cranking amps rating at -18°C
     
     The requirement ensures battery compatibility with vehicle electrical systems..."

Quality Improvement​

Enhance requirement quality with AI suggestions:

You: "How can I improve this requirement?"
AI: "I recommend several improvements:
     1. Add specific acceptance criteria for each specification
     2. Define the test conditions more precisely
     3. Clarify 'vehicle manufacturer's specified compatible group sizes'
     4. Add traceability to battery standards (e.g., BCI specifications)
     
     Here's a suggested improved version:
     [Enhanced requirement text...]
     
     Copy this text and paste it into your requirement editor to apply."
     
You: [Copy the suggestion and manually edit the requirement]

Note: The AI Assistant provides the suggestion, but you must manually copy and apply it to your requirement.

Test Generation Guidance​

Get insights on test coverage:

You: "What test cases should I create for this requirement?"
AI: "For this battery verification requirement, I recommend:
     
     Functional Tests:
     - TC001: Voltage measurement at rest
     - TC002: Voltage under load conditions
     - TC003: Group size physical measurement
     - TC004: CCA rating verification at -18°C
     
     Boundary Tests:
     - TC005: Minimum voltage (11.4V)
     - TC006: Maximum voltage (12.6V)
     
     To create these tests, you can:
     1. Use the 'Generate Tests' feature in Requirements Assist
     2. Manually create test cases using these suggestions
     3. Copy these descriptions for reference"
     
You: [Use Requirements Assist → Generate Tests to actually create them]

Note: The AI Assistant suggests tests but doesn't create them. Use the "Generate Tests" feature (separate from the AI Assistant) to automatically create test cases.

Standards Compliance​

Check compliance with industry standards:

You: "Does this meet ISO 26262 requirements?"
AI: "Analyzing requirement SYSTEM-REQ-00003 against ISO 26262:
     
     ✓ Specific and measurable criteria
     ✓ Testable parameters defined
     ✓ Safety-relevant specifications included
     ⚠ Consider adding failure modes (section 6.4.3)
     ⚠ Add reference to ASIL classification
     
     The requirement partially meets ISO 26262 Part 6 requirements..."

Best Practices​

Ask Specific Questions​

Better:

  • "What voltage tolerance does this requirement specify?"
  • "How does this requirement relate to SYSTEM-REQ-00001?"
  • "Suggest improvements for testability"

Less Effective:

  • "Help"
  • "Tell me about requirements"
  • "What should I do?"

Provide Context​

When asking complex questions, add context:

  • "For an automotive application, does this battery requirement cover all safety aspects?"
  • "In the context of medical device standards, is this requirement complete?"

Use the AI Assistant for Learning​

The AI can help you understand:

  • Industry standards and their application
  • Requirements engineering best practices
  • How to write clear, testable requirements
  • Traceability and compliance concepts

Iterate and Refine​

Have a conversation to refine your requirements:

  1. Ask for initial feedback
  2. Request specific improvements
  3. Get alternative phrasings
  4. Validate the enhanced version

Privacy and Security​

Data Handling​

  • Conversations are private: Chat history is not shared between users
  • Project-scoped: The AI only accesses your project's data
  • Secure processing: All interactions are encrypted
  • No training data: Your conversations don't train the AI model

Access Control​

  • AI Assistant respects your project permissions
  • Only surfaces information you have access to
  • Maintains the same security level as the UI

Integration with Document Context​

The AI Assistant leverages your project's document library for enhanced responses:

  • Attached Specifications: References uploaded PDFs and documents
  • Version Awareness: Understands which document versions are active
  • Intelligent Search: Finds relevant sections in your documents
  • Citation: Can reference specific document sections

Example with Document Context:

You: "What does the battery specification document say about CCA ratings?"
AI: "According to EV_Battery_Car_Requirements.pdf (v1.1, Active):
     
     Section 3.2 specifies:
     'Cold Cranking Amps (CCA) rating at -18°C (0°F) must meet or exceed 
     the vehicle manufacturer's minimum CCA requirement.'
     
     This aligns with your current requirement SYSTEM-REQ-00003..."

Keyboard Shortcuts​

Enhance your AI Assistant workflow:

  • Ctrl/Cmd + K: Open/close AI Assistant
  • Enter: Send message
  • Shift + Enter: New line in message
  • Esc: Close AI Assistant
  • ↑ Arrow: Edit previous message
  • ↓ Arrow: Navigate message history

Mobile and Tablet Support​

The AI Assistant is fully responsive and works on:

  • Desktop: Full-featured chat panel
  • Tablet: Collapsible side panel
  • Mobile: Full-screen chat mode with swipe gestures

Limitations​

The AI Assistant is a read-only advisory tool with these important limitations:

  • ❌ Cannot Make Direct Edits: Only provides suggestions; cannot modify requirements, test cases, or any project data
  • ❌ Cannot Execute Actions: Does not create, delete, or update any items in your project
  • ❌ Cannot Generate Artifacts: Does not generate test cases, requirements, or documents (use separate features for that)
  • ✅ Advisory Only: Analyzes, suggests, explains, and recommends
  • Context Window: Works best with focused, specific questions
  • Not a Replacement: Complements but doesn't replace human expertise
  • Language: Optimized for English technical content
  • Response Quality: Depends on quality of uploaded documents and requirement descriptions

What the AI Assistant CAN Do​

Information & Analysis:

  • ✅ Answer questions about requirements
  • ✅ Explain complex specifications
  • ✅ Analyze requirement quality
  • ✅ Compare requirements to standards
  • ✅ Identify potential issues or gaps
  • ✅ Provide suggestions and recommendations
  • ✅ Reference and cite your documents

What the AI Assistant CANNOT Do​

Actions & Modifications:

  • ❌ Edit or modify requirements
  • ❌ Create new requirements
  • ❌ Generate test cases (use "Generate Tests" feature instead)
  • ❌ Link requirements to tests
  • ❌ Update project data
  • ❌ Delete or archive items
  • ❌ Change requirement status
  • ❌ Assign tasks or responsibilities

To Take Action: Use the AI Assistant's suggestions with other Pidima features:

  • Copy suggestions → Paste into requirement editor
  • Use Requirements Assist for AI-powered edits
  • Use Generate Tests for test case creation
  • Manually apply recommended changes

Response Reliability​

The AI Assistant uses advanced AI technology (Claude Sonnet) that:

  • Generates Context-Aware Responses: Based on your documents and requirements
  • Provides Reasoning: Explains suggestions with rationale
  • Acknowledges Uncertainty: Will indicate when it's not certain about information
  • Maintains Conversation Flow: Keeps track of multi-turn discussions
  • Handles Complex Queries: Can analyze requirements against multiple standards simultaneously

Advanced AI Assistant Capabilities​

Multi-Document Analysis​

The AI Assistant can simultaneously analyze multiple documents:

You: "Compare the battery requirements in EV_Battery_Car_Requirements.pdf 
     with ISO_26262_Safety_Standards.pdf"
AI: "Comparing the two documents:
     
     EV Battery Requirements (v1.1):
     - Specifies 12V nominal voltage
     - Operating range: 11.5V - 12.5V
     - Cold cranking amps: 600A at -18°C
     
     ISO 26262 Compliance Gap:
     - Missing ASIL classification (required by section 5.4.2)
     - Need failure mode analysis (section 6.4.3)
     - Should add voltage monitoring requirements
     
     Recommended additions to close compliance gaps..."

Conversation Memory​

The AI Assistant maintains context across your session:

  • Remembers Previous Questions: Builds on earlier discussions
  • Tracks Your Preferences: Learns your terminology and style
  • Maintains Project Context: Knows which requirements you've discussed
  • Preserves Intent: Understands follow-up questions without repetition

Example conversation flow:

You: "Analyze SYSTEM-REQ-00003"
AI: [Provides detailed analysis]
You: "What test cases would validate it?"
AI: [Knows you're still talking about REQ-00003]
You: "Generate them"
AI: [Creates tests for the same requirement]

Integration with Requirements Assist​

The AI Assistant works seamlessly with other AI features in a two-step workflow:

Step 1: Get Advisory (AI Assistant)

  • Open AI Assistant (read-only, advisory)
  • Ask: "How can I improve this requirement?"
  • Receive suggestions and recommendations
  • Copy useful suggestions

Step 2: Take Action (Requirements Assist)

  • Close AI Assistant or keep it open for reference
  • Use Requirements Assist features (actionable):
    • Autofill: AI fills in missing fields
    • Rewrite: AI rewrites requirement text
    • Enhance: AI improves clarity and quality
    • Generate Child Requirements: Creates derived requirements
  • Review and approve AI-generated changes
  • Changes are applied to your requirement

Important Distinction:

  • AI Assistant = Advisory/Information (read-only, no changes)
  • Requirements Assist = Actionable (makes actual changes with your approval)

This workflow combines AI intelligence (AI Assistant suggestions) with actionable tools (Requirements Assist edits).

Tips for Maximum Effectiveness​

  1. Start Broad, Then Narrow: Begin with general questions, then drill down
  2. Use Examples: "Like SYSTEM-REQ-00001, but for software components"
  3. Ask for Alternatives: "Give me three ways to phrase this requirement"
  4. Validate Suggestions: Always review AI recommendations with domain expertise
  5. Combine with Other Features: Use AI Assistant insights to inform Requirements Assist actions
  6. Reference Documents: Mention specific documents by name for targeted analysis
  7. Ask for Explanations: Request rationale behind AI suggestions
  8. Iterate on Responses: Refine suggestions through follow-up questions

Feedback and Improvement​

Help improve the AI Assistant:

  • Use the thumbs up/down icons to rate responses
  • Report issues via the feedback button
  • Suggest improvements through your account manager