Runtime tools

1
{
2
  "name": "get_weather",
3
  "description": "Get current weather for a city",
4
  "toolType": "external",
5
  "parametersSchema": {
6
    "type": "object",
7
    "properties": {
8
      "city": { "type": "string" }
9
    },
10
    "required": ["city"]
11
  },
12
  "config": {
13
    "url": "https://api.weather.com/v1/current?city={{city}}",
14
    "method": "GET",
15
    "headers": {
16
      "authorization": "Bearer {{secrets.api_key}}"
17
    }
18
  }
19
}

1
{
2
  "name": "calculate_discount",
3
  "description": "Calculate discount percentage",
4
  "toolType": "custom",
5
  "parametersSchema": {
6
    "type": "object",
7
    "properties": {
8
      "price": { "type": "number" },
9
      "discount": { "type": "number" }
10
    },
11
    "required": ["price", "discount"]
12
  },
13
  "config": {
14
    "code": "return { discounted_price: price * (1 - discount / 100) }",
15
    "timeout": 5000,
16
    "language": "javascript"
17
  }
18
}

1
{
2
  "name": "analyze_sentiment",
3
  "description": "Run sentiment analysis flow",
4
  "toolType": "flow",
5
  "parametersSchema": {
6
    "type": "object",
7
    "properties": {
8
      "text": { "type": "string" }
9
    },
10
    "required": ["text"]
11
  },
12
  "config": {
13
    "flowId": "flow_abc123",
14
    "parameterMapping": { "input_text": "text" },
15
    "outputMapping": "sentiment_result"
16
  }
17
}

1
{
2
  "name": "research_topic",
3
  "description": "Spawn a research subagent",
4
  "toolType": "subagent",
5
  "parametersSchema": {
6
    "type": "object",
7
    "properties": {
8
      "task": { "type": "string" }
9
    },
10
    "required": ["task"]
11
  },
12
  "config": {
13
    "agentId": "agent_abc123",
14
    "allowedTools": ["builtin:exa", "builtin:firecrawl"],
15
    "maxTurns": 5,
16
    "outputFormat": "text"
17
  }
18
}

1
{
2
  "subagentConfig": {
3
    "toolPool": ["builtin:exa", "mcp:linear:*"],
4
    "defaultMaxTurns": 5,
5
    "maxTurnsLimit": 10,
6
    "maxSpawnsPerRun": 5,
7
    "allowNesting": false
8
  }
9
}

1
{
2
  "flow": {
3
    "name": "My Assistant",
4
    "steps": [
5
      {
6
        "id": "step-1",
7
        "type": "prompt",
8
        "name": "Assistant",
9
        "order": 1,
10
        "enabled": true,
11
        "config": {
12
          "model": "gpt-5.4-mini",
13
          "systemPrompt": "You are a helpful assistant.",
14
          "tools": {
15
            "runtimeTools": [
16
              {
17
                "name": "search_web",
18
                "description": "Search the web",
19
                "toolType": "external",
20
                "parametersSchema": {
21
                  "type": "object",
22
                  "properties": {
23
                    "query": { "type": "string" }
24
                  },
25
                  "required": ["query"]
26
                },
27
                "config": {
28
                  "url": "https://api.search.com/search?q={{query}}",
29
                  "method": "GET"
30
                }
31
              }
32
            ]
33
          }
34
        }
35
      }
36
    ]
37
  },
38
  "options": {
39
    "streamResponse": true,
40
    "flowMode": "virtual"
41
  }
42
}

1
{
2
  "tools": {
3
    "toolIds": ["tool_abc123", "builtin:exa"],
4
    "runtimeTools": [
5
      { "name": "my_runtime_tool", "..." : "..." }
6
    ]
7
  }
8
}

1
{
2
  "secrets": {
3
    "api_key": "your-api-key"
4
  }
5
}