Understanding Content Ingestion in Kadal

What is Content Ingestion in Kadal? 

Content ingestion in Kadal is the process where uploaded files are analyzed, processed, and structured so they can be used for AI-powered responses, search, and collaboration.

This allows users to:

• Retrieve content from the repository easily.
• Use AI Buddy and agents to generate insights from uploaded documents.
• Enhance search functionality with structured metadata and indexing.

What Happens When You Upload a File?

When a file is uploaded, it goes through the following stages:

1. Processing 

• Indication:
• The file is actively being analyzed, indexed, and ingested into the system.
• Note:
  • The file can be selected when creating agents, but users should be aware that responses from AI might be incomplete until processing is done.
  • Editing, replacing, and updating metadata is disabled during this stage.
  • The file cannot be shared yet and won’t appear under "Shared with Me" until processing is complete.
    
    

2. Processed & Available

• Indication: No Icon 
• The file has been successfully ingested and is ready for AI interactions and searches.
• Note:
  • The file is fully functional in AI Buddy, AI Agents, and repository search.
  • Users can edit metadata, replace, share, and update attributes.
  • The file appears under Shared with Me if shared.
    
    

3. Not Processed

• Indication: No Icon 
• The files that have not been processed. This includes unsupported file types, which are not taken for ingestion.
  
  

4. Failed 

• Indication:
• The file could not be processed due to corruption, unsupported format, or size restrictions.
• Action: Replace or re-upload the file with a valid version to restart ingestion.
• Note:
  • The failed file cannot be used in AI Buddy or AI Agents.
  • Users cannot edit metadata or update attributes until the file is replaced.
  • Replacement is enabled so users can re-upload a corrected file.
  • The file can still be moved, deleted, or downloaded (based on user permissions).
  • Shared failed files will not be accessible to the recipients.
    
    

Where Can Ingested Content Be Used?

Once a file is successfully processed, it can be used in:

• AI Buddy & AI Chat: AI can extract information from the document to generate responses.
• My Agents: Custom agents can utilize the file for answering queries.
• Repository: Users can search, retrieve, and manage content efficiently.
• Metadata & Auto-Tagging: AI enhances the file with structured data for improved organization.
  
  

What to Do If Your File Fails to Process?

1. Check File Format & Size: Ensure the file is in a supported format (PDF, DOCX, CSV, etc.) and within size limits.
2. Re-upload the File: Replace or re-upload the file with a valid version to restart ingestion.
3. Check Error Messages: If a specific issue is mentioned, follow the suggested resolution.
4. Contact Support: If the file repeatedly fails, reach out to [e-mail] for assistance.

Best Practices for Uploading Files

To optimize AI responses and ensure efficient file processing, follow these best practices:

• Use Input Files for Full-Document Queries:
  If a query requires scanning the entire document rather than retrieving information from specific sections, upload the document as an Input File.
• Character Limit for Chat-Time Uploads:
  • The total text across all uploaded files in a single query should not exceed 350,000 characters (approximately 100,000 tokens).
  • You can upload up to three files at a time.
• File Replacement Rule:
  • Only the three most recently uploaded files will be considered for query responses.
  • If a new file is uploaded beyond this limit, the oldest file will be removed from consideration.
• Avoid Large Non-Selectable PDFs:
  • Scanned PDFs exceeding 200 pages can be processed but will take significantly more time.
  • Whenever possible, use selectable text PDFs instead of image-based PDFs to improve processing speed.

By following these best practices, you can ensure that your files are ingested efficiently and that AI responses remain accurate and relevant.

Permissions & Restrictions Based on File Status

File Status	Can  Select for Agents	Can  Edit Metadata	Can  Share	Can  Move/Delete/Download
In Process	✅ Yes	❌ No	❌ No	✅ Yes
Processed	✅ Yes	✅ Yes	✅ Yes	✅ Yes
Failed	❌ No	❌ No	❌ No	✅ Yes