> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roe-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# run_agent_sync

> Run an Agent to process unstructured data synchronously.

## Inputs

`agent_id` (String): The ID of the [Agent](/agents/introduction) to run.

`args` (Map): A map of [Agent Inputs](/agents/input-definition) to pass to the Agent.

## Output

Varies depending on the Agent. The output of an Agent depends on the underlying
[Enging](/agents/engines/introduction) powering the Agent.

## Example Usage

Assuming the underlying Agent is expecting two Agent inputs with keys `prompt`
and `target`:

```sql theme={null}
SELECT run_agent(
  '123e4567-e89b-12d3-a456-426614174000',
  map(
    'prompt', 'Extract entities',
    'target', file_column
  )
) FROM data_table;
```