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

# Get State

# Get Agent State

The Get Agent State node retrieves the current state of an agent in a specified plugin. It allows you to access and use the agent's state information in your spell.

## Inputs

* `flow` (required): The input flow containing the data to be processed.
* `plugin` (optional): The name of the plugin where the agent is located. Default is "core". Choices include:
  * `core`: The default Magick core plugin.
  * `discord`: The Discord plugin for integrating with Discord.
  * `slack`: The Slack plugin for integrating with Slack.

## Outputs

* `flow`: The output flow with the retrieved agent state added.
* `state`: The current state of the agent as an object.

## Configuration

This node does not have any additional configuration options.

## Usage

1. Connect the input `flow` to the node from which you want to retrieve the agent state.
2. (Optional) Select the desired `plugin` from the dropdown menu if the agent is not in the default "core" plugin.
3. Connect the output `flow` to the next node in your spell.
4. Use the `state` output to access the agent's current state information in subsequent nodes.

## Example

Here's an example of how to use the Get Agent State node in a spell:

```markdown theme={null}
1. Start Trigger
2. Get Agent State
   - plugin: "discord"
3. Code
   - input: `state`
   - code: `console.log(state.name)`
4. Send Message
   - message: `The current agent state is: ${state}`
```

In this example, the Get Agent State node retrieves the state of an agent in the "discord" plugin. The `state` output is then passed to a Code node, which logs the agent's name to the console. Finally, the Send Message node sends a message containing the entire agent state object.

## Best Practices

* Use the Get Agent State node when you need to access and utilize the current state information of an agent in your spell.
* Make sure to select the correct `plugin` if the agent is not in the default "core" plugin.
* Use the `state` output to access specific properties of the agent state object in subsequent nodes.

## Common Issues

* If the specified `plugin` is not found or the agent does not exist, the node will output an empty `state` object.
* Ensure that the agent has a valid state before using this node, otherwise, the `state` output may be undefined or empty.

By using the Get Agent State node, you can easily retrieve and work with the current state of an agent in your Magick spells, enabling more dynamic and interactive workflows.