---
canonical_url: "https://docs.composio.dev/toolkits/futureagi"
markdown_url: "https://docs.composio.dev/toolkits/futureagi.md"
product: "platform"
version: null
last_updated: null
---

# FutureAGI

FutureAGI provides evaluation, observability, simulation, dataset, and annotation APIs for building and improving AI systems.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `FUTUREAGI`
- **Version:** 00000000_00

## Tools

### List Agent Definitions

**Slug:** `FUTUREAGI_LIST_AGENT_DEFINITIONS`

List one page of agent definitions in the connected FutureAGI organization, optionally filtering by type, name, assistant ID, or agent ID. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of agent definitions requested per page. Must be at least 1; the provider maximum is not documented. |
| `search` | string | No | Search agent names or assistant IDs. |
| `agent_type` | string ("voice" | "text") | No | Filter by agent type: voice or text. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Reapply the same filters when continuing. |
| `agent_definition_id` | string | No | Known agent definition ID to pin or narrow in the results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Annotation Labels

**Slug:** `FUTUREAGI_LIST_ANNOTATION_LABELS`

List one page of FutureAGI annotation labels by type, name, project, or dataset, optionally including usage counts. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("text" | "categorical" | "numeric" | "star" | "thumbs_up_down") | No | Filter by label type: text, categorical, numeric, star, or thumbs_up_down. |
| `limit` | integer | No | Number of labels requested per page. Must be at least 1; the provider maximum is not documented. |
| `search` | string | No | Search labels by name. |
| `dataset` | string | No | Filter labels by dataset UUID. |
| `project_id` | string | No | Filter labels by project UUID. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Reapply the same filters when continuing. |
| `include_usage_count` | boolean | No | Whether to request each label's usage count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Annotation Queues

**Slug:** `FUTUREAGI_LIST_ANNOTATION_QUEUES`

List one page of FutureAGI annotation queues by status or name, optionally including item counts. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Search annotation queues by name. |
| `status` | string | No | Filter by an exact FutureAGI queue status. FutureAGI does not document a closed set of status values; an unmatched value returns no queues. |
| `page_size` | integer | No | Number of queues requested per page. Must be at least 1; the provider maximum is not documented. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit for the first page and reapply the same filters when continuing. |
| `include_counts` | boolean | No | Whether to request item counts for each queue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Custom Eval Configs

**Slug:** `FUTUREAGI_LIST_CUSTOM_EVAL_CONFIGS`

List custom evaluation configurations, optionally restricted to a FutureAGI project or evaluation task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | No | Filter custom evaluation configs by evaluation task ID. |
| `project_id` | string | No | Filter custom evaluation configs by project ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Datasets

**Slug:** `FUTUREAGI_LIST_DATASETS`

List one page of datasets in the connected FutureAGI organization, optionally searching by name. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Number of datasets requested per page. Must be at least 1; the provider maximum is not documented. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit for the first page and reapply search_text when continuing. |
| `search_text` | string | No | Search datasets by name text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Eval Tasks

**Slug:** `FUTUREAGI_LIST_EVAL_TASKS`

List one page of FutureAGI evaluation tasks, optionally filtering by project ID or task name. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter evaluation tasks by task name. |
| `page_size` | integer | No | Number of evaluation tasks requested in this page. The provider does not document a maximum. |
| `project_id` | string | No | Filter evaluation tasks by project ID. |
| `next_cursor` | string | No | Continuation cursor from a previous call. Omit for the first page and reapply the same filters when continuing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Personas

**Slug:** `FUTUREAGI_LIST_PERSONAS`

List one page of built-in and workspace personas for FutureAGI simulations, with type, simulation-mode, and text filters. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("prebuilt" | "custom") | No | Filter by persona type: prebuilt or custom. |
| `limit` | integer | No | Number of personas requested per page. The provider maximum is not documented. |
| `search` | string | No | Search personas by keyword. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit for the first page and reapply the same filters when continuing. |
| `simulation_type` | string ("voice" | "text") | No | Filter by simulation type: voice or text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Run Tests

**Slug:** `FUTUREAGI_LIST_RUN_TESTS`

List one page of configured FutureAGI run tests without executing them, optionally filtering by name, source type, or prompt template. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of run tests requested per page; must be at least 1. The provider maximum is not documented. |
| `search` | string | No | Search run tests by name. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Reapply the same filters when continuing. |
| `simulation_type` | string ("agent_definition" | "prompt") | No | Filter by source type: agent_definition or prompt. |
| `prompt_template_id` | string | No | Filter by prompt template ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Scenarios

**Slug:** `FUTUREAGI_LIST_SCENARIOS`

List one page of FutureAGI simulation scenarios, optionally filtering by agent definition, agent type, or search text. Returns next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of scenarios requested per page. Must be at least 1; FutureAGI does not document a maximum. |
| `search` | string | No | Search scenarios by name or provider-supported text fields. |
| `agent_type` | string ("voice" | "text") | No | Filter by agent type: voice or text. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit for the first page and reapply the same filters when continuing. |
| `agent_definition_id` | string | No | Filter to scenarios associated with this agent definition ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |