App Task

Overview

App Tasks enable integration with external tools and applications in your workflow. These tasks are designed for operations like data processing, file operations, and API integrations.

Visual Example

Configuration Structure

{
  "type": "APP_TASK",
  "block": {
    "name": "App Task Name",
    "type": "APP_TASK",
    "instructions": "Task instructions",
    "provider": "provider_name",
    "tool_name": "tool_name",
    "tool_id": 123,
    "org_integration_id": null,
    "input_parameters": [],
    "expected_output": [],
    "dependencies": [],
    "error_policy": "RAISE"
  }
}

Required Fields

Field	Type	Description	Required
name	string	Task identifier	Yes
instructions	string	Task instructions	Yes
provider	string	Tool provider	Yes
tool_name	string	Name of the tool	Yes
tool_id	integer	Tool identifier	Yes
org_integration_id	integer	Organization integration ID	No
input_parameters	array	Input configuration	Yes
expected_output	array	Output configuration	Yes

Provider Types

Available providers for App Tasks:

PDF
CSV
Drive
Code
Email
Notion
Custom

Input Parameters

Basic Input

{
  "name": "filename",
  "type": "STRING",
  "description": "Name of the file to process",
  "required": true,
  "source": "task_config"
}

File Content Input

{
  "name": "file_content",
  "type": "STRING",
  "description": "Content to write to file",
  "required": true,
  "source": "task_config"
}

Configuration Input

{
  "name": "settings",
  "type": "OBJECT",
  "description": "Tool configuration settings",
  "properties": [
    {
      "name": "format",
      "type": "STRING",
      "description": "Output format",
      "required": true
    },
    {
      "name": "options",
      "type": "OBJECT",
      "description": "Additional options"
    }
  ]
}

Output Parameters

File Output

{
  "name": "processed_file",
  "type": "FILE",
  "description": "Processed file output"
}

API Response

{
  "name": "api_response",
  "type": "OBJECT",
  "properties": {
    "status": {
      "type": "STRING",
      "description": "Response status"
    },
    "data": {
      "type": "OBJECT",
      "description": "Response data"
    }
  }
}

Common Use Cases

1. PDF Generation

{
  "name": "Generate PDF",
  "provider": "pdf",
  "tool_name": "writer",
  "tool_id": 12,
  "input_parameters": [
    {
      "name": "html_content",
      "type": "STRING",
      "description": "HTML content for PDF",
      "required": true
    },
    {
      "name": "filename",
      "type": "STRING",
      "description": "Output filename",
      "required": true
    }
  ],
  "expected_output": [
    {
      "name": "pdf_url",
      "type": "STRING",
      "description": "URL of generated PDF"
    }
  ]
}

2. CSV Processing

{
  "name": "Process CSV",
  "provider": "csv",
  "tool_name": "processor",
  "tool_id": 34,
  "input_parameters": [
    {
      "name": "csv_data",
      "type": "ARRAY",
      "description": "CSV data to process",
      "required": true
    }
  ],
  "expected_output": [
    {
      "name": "processed_data",
      "type": "ARRAY",
      "description": "Processed CSV data"
    }
  ]
}

Integration Configuration

Tool Setup

{
  "provider": "provider_name",
  "tool_name": "tool_name",
  "tool_id": 123,
  "org_integration_id": 456
}

Authentication

{
  "auth_type": "oauth|apikey|basic",
  "credentials": {
    "key": "value"
  }
}

Best Practices

1. Tool Selection

✅ Do:

Choose appropriate provider
Verify tool capabilities
Check authentication requirements
Test integration thoroughly

❌ Don’t:

Use deprecated tools
Ignore rate limits
Skip error handling

2. Input Configuration

✅ Do:

Validate input formats
Document requirements
Handle file types correctly
Set appropriate timeouts

❌ Don’t:

Skip validation
Ignore size limits
Use hardcoded credentials

Error Handling

Common Errors

Authentication Failures
Rate Limiting
Invalid Input
Network Issues

Error Policy

{
  "error_policy": "RAISE|IGNORE|RETRY",
  "max_retries": 3,
  "retry_delay": 60
}

Provider-Specific Examples

PDF Provider

{
  "provider": "pdf",
  "tool_name": "writer",
  "input_parameters": [
    {
      "name": "template",
      "type": "STRING",
      "description": "PDF template"
    },
    {
      "name": "data",
      "type": "OBJECT",
      "description": "Template data"
    }
  ]
}

Drive Provider

{
  "provider": "drive",
  "tool_name": "file_manager",
  "input_parameters": [
    {
      "name": "file_id",
      "type": "STRING",
      "description": "Drive file ID"
    }
  ]
}

Integration Flow

Common Issues and Solutions

Issue	Solution
Authentication Failed	Verify credentials and permissions
Rate Limit Exceeded	Implement backoff strategy
Invalid Input Format	Validate input before processing
Tool Unavailable	Check tool status and fallback

Agent

Tasks

Tools

Parameters

Knowledge

Guides

Examples

Overview

Visual Example

Configuration Structure

Required Fields

Provider Types

Input Parameters

Basic Input

File Content Input

Configuration Input

Output Parameters

File Output

API Response

Common Use Cases

1. PDF Generation

2. CSV Processing

Integration Configuration

Tool Setup

Authentication

Best Practices

1. Tool Selection

2. Input Configuration

Error Handling

Common Errors

Error Policy

Provider-Specific Examples

PDF Provider

Drive Provider

Integration Flow

Common Issues and Solutions

​Overview

​Visual Example

​Configuration Structure

​Required Fields

​Provider Types

​Input Parameters

​Basic Input

​File Content Input

​Configuration Input

​Output Parameters

​File Output

​API Response

​Common Use Cases

​1. PDF Generation

​2. CSV Processing

​Integration Configuration

​Tool Setup

​Authentication

​Best Practices

​1. Tool Selection

​2. Input Configuration

​Error Handling

​Common Errors

​Error Policy

​Provider-Specific Examples

​PDF Provider

​Drive Provider

​Integration Flow

​Common Issues and Solutions

Overview

Visual Example

Configuration Structure

Required Fields

Provider Types

Input Parameters

Basic Input

File Content Input

Configuration Input

Output Parameters

File Output

API Response

Common Use Cases

1. PDF Generation

2. CSV Processing

Integration Configuration

Tool Setup

Authentication

Best Practices

1. Tool Selection

2. Input Configuration

Error Handling

Common Errors

Error Policy

Provider-Specific Examples

PDF Provider

Drive Provider

Integration Flow

Common Issues and Solutions