LLM-Driven Extraction of Unstructured Data — Built for API Deployments & ETL Pipeline Workflows
Python ai-agentsdata-engineeringdocument-aigenerative-aiidpjson-extractionllmmcp-serverocrpdf-extractionprompt-engineeringstructured-output
"""Request validation, and the response envelope for drf-spectacular.
The view builds plain dicts; the tested contract is
``contract/search-response.schema.json``.
"""
from rest_framework import serializers
from global_search.constants import MatchTier, SearchParams
class SearchQuerySerializer(serializers.Serializer):
q = serializers.CharField(
required=False,
allow_blank=True,
trim_whitespace=True,
max_length=SearchParams.MAX_QUERY_LENGTH,
default="",
help_text=(
"Case-insensitive text matched against name and description. "
f"Shorter than {SearchParams.MIN_QUERY_LENGTH} characters after "
"trimming returns no groups."
),
)
types = serializers.CharField(
required=False,
allow_blank=True,
default="",
help_text=(
"Comma-separated type keys to search. Empty means all. Unknown or "
"unavailable keys are ignored."
),
)
limit = serializers.IntegerField(
required=False,
default=SearchParams.DEFAULT_LIMIT,
min_value=1,
max_value=SearchParams.MAX_LIMIT,
help_text="Results per type.",
)
def validate_types(self, value: str) -> list[str]:
return [key for key in (part.strip() for part in value.split(",")) if key]
class SearchRouteSerializer(serializers.Serializer):
key = serializers.CharField(help_text="Route-registry name, not a URL.")
params = serializers.DictField(child=serializers.CharField())
class SearchResultSerializer(serializers.Serializer):
type = serializers.CharField()
id = serializers.CharField()
name = serializers.CharField(allow_blank=True)
context = serializers.CharField(
allow_null=True, help_text="One display-only line; see README for each type."
)
match = serializers.ChoiceField(choices=[tier.label for tier in MatchTier])
route = SearchRouteSerializer()
class SearchGroupSerializer(serializers.Serializer):
type = serializers.CharField()
label = serializers.CharField()
has_more = serializers.BooleanField()
results = SearchResultSerializer(many=True)
class SearchResponseSerializer(serializers.Serializer):
query = serializers.CharField(allow_blank=True)
groups = SearchGroupSerializer(many=True)
failed_types = serializers.ListField(
child=serializers.CharField(),
help_text="Types whose search failed; their groups are missing.",
)