Advanced Conversational Settings (LLM Provider, external tools)

this section details the configuration options for managing core aspects of the digital human's conversational behavior, including the selection of the underlying language model (llm) provider, model and external tool integrations the platform currently offers integration with the following llm providers openai and groq we are actively developing support for further llm providers, which will be available in upcoming updates configure the llm settings use the put /head/{id}/conversation settings endpoint to configure the llm settings for the digital human the following parameters are required provider specify the exact llm model to be used expected value string valid values "openai" use an openai model "groq" use a groq model default value "openai" llm name specify the exact llm model expected value string possible values refer to your chosen llm provider's documentation ( https //console groq com/docs/models , https //platform openai com/docs/models ) for a list of available models (e g , "gpt 3 5 turbo", "gpt 4" for openai) default value "gpt 4o mini" max llm tokens specify the max tokens per response expected value integer possible values refer to your chosen llm provider's documentation for the maximum tokens per response default value "8000" api key set the api key of your llm provider service expected value string example request request body "conversationsettings" { "chat model settings" { "provider" "openai", "llm name" "gpt 4o mini", "max llm tokens" 8000, "api key" "your api key" } } curl x 'put' \\ 'https //platform api unith ai/head/yourheadid/conversation settings' \\ h 'accept application/json' \\ h 'authorization bearer yourbearertoken' \\ h 'content type application/json' \\ d '{ "conversationsettings" { "chat model settings" { "provider" "openai", "llm name" "gpt 4 1 mini 2025 04 14", "api key" "yourapikey" } } }' use get /head/{id}/conversation settings to retrieve the digital human's llm settings the put method requires the complete conversationsettings object include all existing parameters you wish to retain, as omitted fields will revert to defaults retrieve current digital human llm settings curl x 'get' \\ 'https //platform api unith ai/head/yourheadid/conversation settings' \\ h 'accept application/json' \\ h 'authorization bearer yourbearertoken' configure the external tools integration configure external tools that can be invoked by the digital human via http post requests this enables the digital human to interact with external services and apis during a conversation please refer to the https //docs unith ai/tools usage guide to learn more about tools