LLM-Driven Extraction of Unstructured Data — Built for API Deployments & ETL Pipeline Workflows
Python ai-agentsdata-engineeringdocument-aigenerative-aiidpjson-extractionllmmcp-serverocrpdf-extractionprompt-engineeringstructured-output
import logging
from django.core.exceptions import ValidationError
from workflow_manager.workflow_v2.models.execution import WorkflowExecution
from api_v2.models import APIDeployment
from api_v2.notification import APINotification
logger = logging.getLogger(__name__)
class APIDeploymentUtils:
@staticmethod
def get_api_by_id(api_id: str) -> APIDeployment | None:
"""Retrieves an APIDeployment instance by its unique ID.
Args:
api_id (str): The unique identifier of the APIDeployment to retrieve.
Returns:
Optional[APIDeployment]: The APIDeployment instance if found,
otherwise None.
A malformed identifier is "not found", not a fault: ``pk`` is a UUID
column, so a non-UUID string raises ``ValidationError`` out of
``to_python`` rather than ``DoesNotExist``. Callers reach this with
unvalidated caller input (path segments are ``<str:>``, and request
bodies are read before the serializer runs), so letting that escape
turns ordinary client garbage into a 500.
"""
try:
api_deployment: APIDeployment = APIDeployment.objects.get(pk=api_id)
return api_deployment
except APIDeployment.DoesNotExist:
return None
except ValidationError:
# Logged so a malformed identifier stays distinguishable from an
# absent row: both answer 404, and without this the difference is
# invisible when triaging.
logger.debug("Malformed API deployment identifier: %s", api_id)
return None
@staticmethod
def send_notification(
api: APIDeployment, workflow_execution: WorkflowExecution
) -> None:
"""Sends a notification for the specified API deployment and workflow
execution.
Args:
api (APIDeployment): The APIDeployment instance for which the
notification is being sent.
workflow_execution (WorkflowExecution): The WorkflowExecution instance
related to the notification.
Returns:
None
"""
api_notification = APINotification(api=api, workflow_execution=workflow_execution)
api_notification.send()