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 and 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 to configure the conversational parameters, a deployed digital human with the operation mode parameter set to "oc" is required operation mode= "oc" 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 ( groq , openai ) 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" } } use the get /head/{id}/conversation settings to retreive the llm settings for the digital human note that if you want to update any parameter you have to provide the whole "conversationsettings" field including the previous parameters that you don't want to change, but you need different thanm the default in the put method 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 use the put /head/{id}/conversation settings to configure the external tool integration with the following parameters this section outlines the process of configuring external tools that the digital human can interact with each tool must be defined with the following parameters tools array an array of tool definitions each element in the array represents a single external tool name string the name of the external tool or the function it performs this name should be descriptive and concise as it will be used to identify the tool when invoked during a conversation example "get weather" desciption a brief description of the tool's functionality this description should clearly explain what the tool does and how it can be used by the llm example "retrieves the current weather for a specified location " parameters array an array of parameter definitions that the llm will use to interact with the tool each element defines a single parameter name string the name of the parameter use clear and descriptive names example "location" description string a description of the parameter, explaining its purpose and what kind of value the llm should provide example · "the city for which to retrieve the weather, e g , san francisco" type string the data type of the parameter this helps the llm understand the expected format of the value common types include "string" for text values "integer" for whole numbers url string the webhook url of the external tool's endpoint that will receive the post request this is the address where the llm will send the data to invoke the tool api key the api key, if required, for authenticating with the external tool's api if the external service is authenticated via headers of the post request example request request body { "conversationsettings" { "tools" \[ { "name" "weather lookup", "description" "get current weather for a location", "parameters" \[ { "name" "location", "description" "city name", "type" "string" }, { "name" "days", "description" "forecast days", "type" "integer" } ], "url" "https //api weather service com/forecast", "api key" "your weather api key" } ] } }