> For the complete documentation index, see [llms.txt](https://bc-security.gitbook.io/empire-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bc-security.gitbook.io/empire-wiki/starkiller/agent-tasks.md).

# Agent Tasks

Agent tasks in Empire are managed through a series of status updates that reflect the lifecycle of a task from creation to completion. These statuses help users understand the current state of tasks assigned to agents. Below are the possible statuses for agent taskings along with descriptions and representative icons.

## Queued

* **Description**: The task is queued for the agent. This status indicates that the task has been created and is waiting to be pulled by the agent.

<figure><img src="/files/b7Ka6Wjs3sfoA7DnuO8n" alt="" width="128"><figcaption></figcaption></figure>

## Pulled

* **Description**: The agent has successfully pulled the tasking. This status signifies that the agent has received the task and is either processing it or about to start processing.

<figure><img src="/files/XVvBu1JqLwUy4z0EtDFP" alt="" width="128"><figcaption></figcaption></figure>

## Completed

* **Description**: The task has returned data successfully. This indicates that the agent has finished executing the task and has returned the output.

<figure><img src="/files/sMFNSthowpm5RbN2SMxy" alt="" width="128"><figcaption></figcaption></figure>

## Error

* **Description**: If an agent reports an error for a task, it will return an ERROR status. This status allows users to identify tasks that did not execute as expected.

<figure><img src="/files/mSfwteG9ahj9qG4CeVBc" alt="" width="128"><figcaption></figcaption></figure>

## Continuous

* **Description**: A special class for modules like keylogging, since they are handled differently on the server due to their continuous nature. These tasks do not have a definite end and run continuously until stopped.

<figure><img src="/files/zMzgKJrPzCRPm4zgyc0x" alt="" width="128"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bc-security.gitbook.io/empire-wiki/starkiller/agent-tasks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.