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

# execute • AI Agent SDK

> execute: Execute a single prompt and return result.

# execute

AsyncMethod

> This is a method of the [**CliBackendProtocol**](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/CliBackendProtocol.md) class in the [**protocols**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) module.

Execute a single prompt and return result.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
async def execute(prompt: str) -> CliBackendResult
```

## Parameters

**prompt** `str` *required*

User prompt/query

### Returns

**Returns** `CliBackendResult`

CliBackendResult with response content and metadata

## Used By

* [`CodeAgent.execute_code`](../functions/CodeAgent-execute_code)
* [`CodeAgent.aexecute`](../functions/CodeAgent-aexecute)
* [`MiddlewareManager.execute_model_call`](../functions/MiddlewareManager-execute_model_call)
* [`MiddlewareManager.execute_tool_call`](../functions/MiddlewareManager-execute_tool_call)
* [`fire_hook`](../functions/fire_hook)

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/cli_backend/protocols.py#L114)
>
> `praisonaiagents/cli_backend/protocols.py` at line 114


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.