AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
TypeScript ai-agentai-agent-toolsai-agentsai-agents-frameworkmcpmcp-servermcp-toolsmcpsn8n-alternativeno-code-automationworkflowworkflow-automationworkflows
import { HttpMethod } from '@activepieces/pieces-common';
import { createAction, Property } from '@activepieces/pieces-framework';
import { parallelAuth } from '../auth';
import { parallelClient, TASK_PROCESSORS } from '../common/client';
export const createTaskRunAction = createAction({
auth: parallelAuth,
name: 'create_task_run',
classification: 'READ',
displayName: 'Create Task Run',
description:
'Initiate a Parallel research task. Returns immediately with a queued run; use Get Task Run Result to wait for completion.',
audience: 'both',
aiMetadata: {
description:
'Start an asynchronous multi-hop research task on Parallel for a free-text or JSON input, selecting a speed/depth processor tier and optionally constraining output to plain text or a JSON Schema. Use it to kick off deeper research than a single search; it returns immediately with a queued run id that you then poll with Get Task Run Status or block on with Get Task Run Result. Not idempotent: each call queues a new run.',
idempotent: false,
},
props: {
input: Property.LongText({
displayName: 'Input',
description:
'Input to the task (free text or a JSON string). Example: "What was the GDP of France in 2023?"',
required: true,
}),
processor: Property.StaticDropdown({
displayName: 'Processor',
description: 'Speed/depth tier for the task.',
required: true,
defaultValue: 'base',
options: { options: TASK_PROCESSORS },
}),
output_schema_type: Property.StaticDropdown({
displayName: 'Output Schema Type',
description: 'How the task should structure its output.',
required: false,
defaultValue: 'auto',
options: {
options: [
{ label: 'Auto', value: 'auto' },
{ label: 'Text', value: 'text' },
{ label: 'JSON Schema', value: 'json' },
],
},
}),
output_text_description: Property.LongText({
displayName: 'Output Description (Text)',
description:
'Used when Output Schema Type is "Text". Plain-language description of the desired output.',
required: false,
}),
output_json_schema: Property.Json({
displayName: 'Output JSON Schema',
description:
'Used when Output Schema Type is "JSON Schema". A JSON Schema object describing the desired structured output.',
required: false,
}),
include_domains: Property.Array({
displayName: 'Include Domains',
description: 'Optional source policy: only return results from these domains.',
required: false,
}),
exclude_domains: Property.Array({
displayName: 'Exclude Domains',
description: 'Optional source policy: exclude results from these domains.',
required: false,
}),
metadata: Property.Object({
displayName: 'Metadata',
description:
'Optional key/value metadata stored with the run (keys ≤16 chars, values ≤512 chars).',
required: false,
}),
},
async run(context) {
const props = context.propsValue;
const includeDomains = ((props.include_domains ?? []) as unknown[]).filter(
(d): d is string => typeof d === 'string' && d.trim().length > 0,
);
const excludeDomains = ((props.exclude_domains ?? []) as unknown[]).filter(
(d): d is string => typeof d === 'string' && d.trim().length > 0,
);
const sourcePolicy =
includeDomains.length || excludeDomains.length
? {
...(includeDomains.length ? { include_domains: includeDomains } : {}),
...(excludeDomains.length ? { exclude_domains: excludeDomains } : {}),
}
: undefined;
const taskSpec = buildTaskSpec({
type: props.output_schema_type,
textDescription: props.output_text_description,
jsonSchema: props.output_json_schema,
});
const body: Record<string, unknown> = {
input: props.input,
processor: props.processor,
};
if (taskSpec) body['task_spec'] = taskSpec;
if (sourcePolicy) body['source_policy'] = sourcePolicy;
if (props.metadata && Object.keys(props.metadata).length > 0) {
body['metadata'] = props.metadata;
}
return await parallelClient.request({
apiKey: context.auth.secret_text,
method: HttpMethod.POST,
path: '/v1/tasks/runs',
body,
});
},
});
function buildTaskSpec({
type,
textDescription,
jsonSchema,
}: {
type: string | undefined;
textDescription: string | undefined;
jsonSchema: unknown;
}): Record<string, unknown> | undefined {
if (!type || type === 'auto') {
return undefined;
}
if (type === 'text') {
if (!textDescription) return undefined;
return {
output_schema: { type: 'text', description: textDescription },
};
}
if (type === 'json') {
if (!jsonSchema || typeof jsonSchema !== 'object') return undefined;
return {
output_schema: { type: 'json', json_schema: jsonSchema },
};
}
return undefined;
}