Documentation/Configuration/ExtensionConfiguration.rst
.. include:: /Includes.rst.txt
.. _extension-configuration:
=======================
Extension configuration
=======================
The extension currently provides the following configuration options:
.. _extconf-provider:
.. confval:: provider
:type: string (FQCN)
:Default: :php:class:`EliasHaeussler\\Typo3Solver\\ProblemSolving\\Solution\\Provider\\OpenAISolutionProvider`
Default solution provider to be used for problem solving.
.. note::
Custom solutions providers must implement
:php:interface:`EliasHaeussler\\Typo3Solver\\ProblemSolving\\Solution\\Provider\\SolutionProvider`.
.. _extconf-prompt:
.. confval:: prompt
:type: string (FQCN)
:Default: :php:class:`EliasHaeussler\\Typo3Solver\\ProblemSolving\\Solution\\Prompt\\DefaultPrompt`
Default prompt to be used for problem solving.
.. note::
Custom prompts must implement
:php:interface:`EliasHaeussler\\Typo3Solver\\ProblemSolving\\Solution\\Prompt\\Prompt`.
.. _extconf-ignoredCodes:
.. confval:: ignoredCodes
:type: string (comma-separated list)
Comma-separated list of exception codes to ignore during problem solving.
Once a raised exception matches with the configured exception codes, the
solution provider won't provide a solution and is simply ignored.
.. note::
This setting only applies to the default
:php:class:`EliasHaeussler\\Typo3Solver\\ProblemSolving\\Solution\\Provider\\OpenAISolutionProvider`.
.. _extconf-api-key:
.. confval:: api.key
:type: string
:ref:`API key <api-key>` for OpenAI requests.
.. attention::
It is essential to configure the API key. Otherwise, requests to OpenAI
won't be possible.
.. _extconf-attributes-model:
.. confval:: attributes.model
:type: string
:Default: `gpt-3.5-turbo-0301`
`OpenAI model <https://platform.openai.com/docs/models>`__ to use (see
:ref:`List available models <solver-list-models>` to show a list of available
models).
.. _extconf-attributes-maxTokens:
.. confval:: attributes.maxTokens
:type: integer
:Default: `300`
`Maximum number of tokens <https://platform.openai.com/docs/api-reference/chat/create#chat/create-max_tokens>`__
to use per request to OpenAI.
.. _extconf-attributes-temperature:
.. confval:: attributes.temperature
:type: float
:Default: `0.5`
`Temperature <https://platform.openai.com/docs/api-reference/chat/create#chat/create-temperature>`__
to use for OpenAI completion requests (must be a value between `0` and `1`).
.. _extconf-attributes-numberOfCompletions:
.. confval:: attributes.numberOfCompletions
:type: integer
:Default: `1`
`Number of completions <https://platform.openai.com/docs/api-reference/chat/create#chat/create-n>`__
to generate for each problem.
.. _extconf-cache-lifetime:
.. confval:: cache.lifetime
:type: integer
:Default: `86400` *(= 1 day)*
Lifetime in seconds of the solutions cache.
.. tip::
Use `0` to disable caching.