View as Markdown
Utopian Labs icon

Utopian Labs ACTION

Initiate Research Run

Initiate a research run of the R1 agent. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Utopian Labs account once, then configure and run Initiate Research Run from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "utopian_labs-initiate-research-run",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    utopian_labs: { authProvisionId: "apn_xxxxxxx" },
    agent: "Agent",
    lead: "Lead",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Initiate Research Run inputs
Property Type Description
agent Agent string
The agent to run
Required
lead Lead object
The lead to research. See the documentation for more information. Example: { "company": { "website": "https://pipedream.com/" } }
Required
minResearchSteps Minimum Research Steps integer
Optionally limit the agent to a minimum amount of research steps (default is 0)
Optional
maxResearchSteps Maximum Research Steps integer
Optionally limit the agent to a maximum amount of research steps (default is 5)
Optional
context Context string
The context for the run. This is a free-form string that will be used to guide the agent's research
Optional
additionalOptions Additional Options object
Additional parameters to send in the request. See the documentation for all available parameters. Values will be parsed as JSON where applicable.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
utopian_labs-initiate-research-run
Version
0.0.2
App
Utopian Labs
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes