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

# Setup and Register

Custom agents let you plug your own HTTPS endpoints into Encord and trigger them in the Label Editor, or as part of your Workflow.

## Set Up Custom Agents

First you must [create and host](/agents-documentation/Custom-Agents/GCP-Cloud-Functions) the HTTPS endpoint that acts as your agent.

At a high level, your backend should:

* Accept a JSON payload from Encord describing the current project, data item, and frame.
* Use the Encord SDK or API (and any external models you choose) to perform work.
* Write results back to Encord (for example, updating labels or classifications).
* Return a successful HTTP status code so the editor knows the request completed.

Once saved, the agent appears in the **Enabled** tab of the Agents section.

### Installation

We recommend installing the Encord agents library in an isolated environment. To install `encord-agents` in your current environment, run:

<Tip>
  Installing the `vision` extras is advised for most users. These dependencies optimize performance when handling visual data formats.
</Tip>

<Warning>Encord Agents requires `python >= 3.10`. If you do not have Python 3.10, we recommend using[`pyenv`](https://github.com/pyenv/pyenv) to manage your Python versions.</Warning>

<CodeGroup>
  We recommend installing the Encord agents library in an isolated environment. To install `encord-agents` in your current environment, run:

  ```shell Visual Data theme={"dark"}
  python -m pip install "encord-agents[vision]"
  ```

  ```shell No Visual Data theme={"dark"}
  python -m pip install encord-agents
  ```
</CodeGroup>

## Register Custom Agents

<Note>Only HTTPS endpoints are supported for Custom Agents.</Note>

**To register a Custom Agent using the Agents Catalog:**

1. Go to **Agents** in the left-hand navigation.
2. In the **Agents catalog** tab, select the **Custom agent** tile.

<div class="flex justify-center">
  <img src="https://storage.googleapis.com/docs-media.encord.com/static/img/agents-catalog-custom-agent.png" width="600" />
</div>

3. Fill in the form:
   * Give the agent a clear name and description.
   * Provide the public HTTPS endpoint that Encord should call.
   * Enter possible decisions that the agent can return (for example, "approve" or "reject"). These decisions are represented as pathways in the Workflow. If your agent does not return decisions, you can leave this field blank.
4. Save the configuration to register the Custom Agent.