linkai-agent

# LinkAI Agent Caller

Call LinkAI applications and workflows through API. Supports multiple apps/workflows configured in config.json.

The available apps are dynamically loaded from `config.json` at skill loading time.

## Setup

This skill requires a LinkAI API key. If not configured:

1. Get your API key from https://link-ai.tech/console/api-keys
2. Set the key using: `env_config(action="set", key="LINKAI_API_KEY", value="your-key")`

## Configuration

1. Copy `config.json.template` to `config.json`
2. Configure your apps/workflows:

```json
{
  "apps": [
    {
      "app_code": "your_app_code",
      "app_name": "App Name",
      "app_description": "What this app does"
    }
  ]
}
```

3. The skill description will be automatically updated when the agent loads this skill

## Usage

**Important**: Scripts are located relative to this skill's base directory.

When you see this skill in `<available_skills>`, note the `<base_dir>` path.

**CRITICAL**: Always use `bash` command to execute the script:

```bash
# General pattern (MUST start with bash):
bash "<base_dir>/scripts/call.sh" "<app_code>" "<question>" [model] [stream] [timeout]

# DO NOT execute the script directly like this (WRONG):
# "<base_dir>/scripts/call.sh" ...

# Parameters:
# - app_code: LinkAI app or workflow code (required)
# - question: User question (required)
# - model: Override model (optional, uses app default if not specified)
# - stream: Enable streaming (true/false, default: false)
# - timeout: curl timeout in seconds (default: 120, recommended for video/image generation)
```

**IMPORTANT - Timeout Configuration**:
- The script has a **default timeout of 120 seconds** (suitable for most cases)
- For complex tasks (video generation, large workflows), pass a longer timeout as the 5th parameter
- The bash tool also needs sufficient timeout - set its `timeout` parameter accordingly
- Example: `bash(command="bash <script> <app_code> <question> '' 'false' 180", timeout=200)`

## Examples

### Cal