Skip to main content
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"
}'
⌘I