---
title: Agent
description: "#### **Create Agent** This component allows you to create agents with specific starting properties, such as position, color, and tags. Agents created here will be used in the E**vacuation Solver**. - **Component Name:** `Create Agent` - **Description:** Creates a new…"
url: "https://snhm.io/documentation/agent/"
updated: "2024-09-21"
category: Components Overview
---

# Agent

#### **Create Agent**

This component allows you to create agents with specific starting properties, such as position, color, and tags. Agents created here will be used in the E**vacuation Solver**.

- **Component Name:** `Create Agent`
- **Description:** Creates a new Flow Agent with properties such as starting position, color, and tags.
- **Category:** Flow > Agent

![](https://i0.wp.com/snhm.io/wp-content/uploads/2024/09/CreateAg.png?resize=280%2C301&ssl=1)

##### **Inputs:**

- **Position (P):** The initial position of the agent. This is where the agent starts in the environment. (Type: `Point3d`)
- **Tag (T):** A tag to help identify the agent or group of agents. (Type: `string`)
- **Tag to Exclude (Tx):** (Optional) A tag that defines obstacles or other agents that this agent should avoid. (Type: `string`, default is an empty string)
- **Color (C):** The color assigned to the agent for visualization. (Type: `Color`)

##### **Outputs:**

- **FlowAgent (A):** The created Flow Agent, ready to be added to the simulation. (Type: `List<Agent>`)

---

#### **Agent Properties**

This component is responsible for  retrieving various properties of each agent in the simulation.

- **Component Name:** `Agent Properties`
- **Description:** Retrieves the properties of a Flow Agent, including position, velocity, mesh, color, tags, and unique ID.
- **Category:** Flow > Agent

![](https://i0.wp.com/snhm.io/wp-content/uploads/2024/09/AgPr.png?resize=280%2C515&ssl=1)

##### **Inputs:**

- **FlowAgent (A):** The agent object whose properties are being queried. (Type: Flow Agent)

##### **Outputs:**

- - **Position (P):** The current position of the agent in the environment. (Type: `Point3d`)
  - **Velocity (V):** The velocity vector of the agent, representing its direction and speed of movement. (Type: `Vector3d`)
  - **Mesh (M):** The visual representation of the agent, typically used for rendering purposes. (Type: `Mesh`)
  - **Color (C):** The color assigned to the agent for easy identification in visualizations. (Type: `Color`)
  - **Tag (T):** A list of descriptive tags assigned to the agent for categorization or identification. (Type: `List<string>`)
  - **Tag to Exclude (Tx):** A tag that indicates what the agent should avoid or exclude during the simulation. (Type: `string`)
  - **ID (ID):** A unique integer identifier for each agent in the simulation. (Type: `int`)