Process Text
============

The ProcessText action allows you to process unstructured text using Large Language Models (LLMs) according to provided instructions.
The output is a structured object based on a Pydantic model you define.

Action
------

.. autoclass:: aiviro.actions.documents.ProcessText
   :members:

Data Schemas
---------------

The action returns a :class:`~.ProcessTextResponse` object with:

- ``response``: JSON string containing the structured output
- ``response_json``: Parsed JSON as a dictionary
- ``model_usage``: Optional LLM usage statistics

.. note::
    Always use ``result.response_json`` to access the parsed data, then validate it with your Pydantic model using ``YourModel.model_validate(result.response_json)``.


.. automodule:: aiviro.core.utils.api_client.schemas.process_text
   :members: ProcessTextResponse