Agent inputs are the initial data provided to your agent when executing. They define the parameters and data that your agent will be provided with during execution.

​
Defining Inputs

Inputs are defined in the Agent Builder under the “Inputs” section.
Each input requires:
  • A name
  • A type (string, number, boolean, or json)
  • A default value used when testing in the Builder

​
Input Types

The following input types are supported:
  • string: Text values
  • number: Numeric values
  • boolean: True/false values
  • json: Complex objects and arrays
  • totp: Time-based One-Time Password secrets

​
Sensitive Inputs

We also support sensitive inputs, such as passwords or API keys. These inputs are:
  • Masked in the UI
  • Never passed to LLMs
  • Securely handled throughout the agent execution process
To mark an input as sensitive, select the “Mark as sensitive” checkbox when creating or editing an input.

​
TOTP Authentication for Multi-Factor Authentication (MFA)

The totp input type is a special sensitive input that takes a TOTP (Time-based One-Time Password) secret and automatically generates the corresponding 6-digit code for use in multi-factor authentication flows. This allows your agents to securely authenticate with services that use authenticator apps for MFA without manually generating codes. When you provide a TOTP secret as input, the system will:
  1. Generate the current valid 6-digit code
  2. Make this code available to your agent
  3. Never expose the original TOTP secret to the LLM

​
Example

Let’s say I’m building an agent that types search queries into a search engine. In this case, I’ll want my agent to take the search query as an input.
Here I’ve set up a parameter called search_query that is a string. When I run my agent in my builder, the value of search_query will be What is the weather like?. When I run my agent via API, I’ll need to provide the actual input value the agent will use to type into the search engine. 
curl -X POST https://backend.trykura.com/run_agent \
-H "Content-Type: application/json" \
-d '{
  "agent_id": "37eef9ddf627494488cad015967b842a",
  "parameters": {
    "search_query": "Who won the last Copa America?"
  },
  "api_key": "YOUR_API_KEY"
}'