AI Texas Tax Code Assistant with Qdrant & Mistral

Unlock Automated Legal Information Retrieval with this AI Agent

This AI Agent transforms raw Texas tax code PDFs into an intelligent, queryable knowledge base. It automates the entire pipeline: downloading legal documents, meticulously parsing them into structured chapters and sections, generating semantic embeddings using Mistral AI, and indexing them in a Qdrant vector database. Once set up, you can converse with the AI Agent to ask questions about Texas tax codes, retrieve specific sections, or get summaries, all powered by an OpenAI language model.

This agent demonstrates a powerful Retrieval Augmented Generation (RAG) pattern, making complex legal documents accessible and interactive.

Key Features & Benefits

• AI-Powered Document Ingestion: Automatically fetches, unzips, and processes PDF tax documents from a specified URL.
• Intelligent Text Structuring: Custom logic extracts and organizes raw text into meaningful chapters and sections, significantly improving data quality for AI processing and retrieval.
• Advanced Semantic Search: Leverages Mistral AI embeddings and Qdrant vector search to understand the contextual meaning behind your queries, going beyond simple keyword matching.
• Conversational AI Assistant: Interact naturally with your tax code data using an AI Agent powered by OpenAI models, complete with conversational memory.
• Dual-Tool Functionality for Precision: The AI Agent utilizes two distinct tools for targeted information retrieval:
  • Ask Tool: Provides semantically relevant answers to your natural language questions about tax laws by querying the Qdrant knowledge base.
  • Search Tool: Directly retrieves full text for specific chapters or sections you request, using Qdrant's filtering capabilities.
• Scalable Data Handling: Implements batching for document processing and chunking for embedding generation to handle large documents efficiently and manage API rate limits.
• Customizable & Extensible: Built on n8n, allowing for easy modification of data sources, AI models, and integration with other business systems.
• Empowers Legal & Tax Professionals: Drastically reduces time spent on manual document searches and provides quick, accurate information retrieval, enhancing productivity.

• An n8n instance (Cloud or self-hosted).
• Mistral AI API Key (for embedding generation).
• OpenAI API Key (for the AI Agent's chat model, e.g., gpt-3.5-turbo or gpt-4).
• A Qdrant instance accessible to n8n (e.g., self-hosted via Docker, Qdrant Cloud). The workflow defaults to http://qdrant:6333.

1. Download the n8n workflow JSON file.
2. Import the workflow into your n8n instance.
3. Configure Qdrant: Ensure your Qdrant instance is running and accessible. The workflow is pre-configured to use the URL http://qdrant:6333 and a collection named texas_tax_codes. If your setup differs, update the URLs in the 'Qdrant Vector Store' node (for initial setup/inserts), 'Use Qdrant Search API1' node, and 'Use Qdrant Scroll API' node. You may need to create the texas_tax_codes collection in Qdrant manually with appropriate vector parameters for Mistral embeddings if the 'Qdrant Vector Store' node doesn't create it automatically on first run.
4. Mistral AI Credentials: In the 'Embeddings Mistral Cloud' node, select or create your Mistral AI API credentials.
5. OpenAI Credentials: In the 'OpenAI Chat Model' node, select or create your OpenAI API credentials.
6. (Optional) Data Source: Review the 'Get Tax Code Zip File' node. The URL points to the Texas statutes. If this URL changes, update it here.
7. Initial Data Ingestion: To populate the Qdrant database, manually execute the workflow using the 'When clicking ‘Test workflow’' trigger. This will download, process, and embed the tax code documents. This step can take some time depending on the document size and your n8n server's resources.
8. Activate Chat Agent: The 'When chat message received' node acts as the chat endpoint. Ensure it's active. You can interact with the AI Agent via n8n's chat interface or by making the webhook public and sending requests to it.
9. Start asking questions! For example: "What are the general provisions for sales tax?" or use the search tool by asking the agent to "get section Sec 151.001 of the tax code".