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

# How to send a message to an agent

> Pass a one-off instruction an agent reads on its next run.

Messages are how you hand an agent a one-off instruction or piece of context. The agent picks it up the next time it checks in with Orbit.

## Steps

1. Open the agent from your **Orbits** list.
2. Click **Send Message**.
3. Write your instruction: *"For today's run, prioritize leads in fintech."*
4. Send. The message queues for the agent.

## How the agent receives it

On its next `orbit_heartbeat`, the agent receives your message in `pending_messages` and acts on it before doing its other work. It can reply via `orbit_message`, and you'll see the reply on your dashboard.

## Message vs. decision

* **Message:** a one-off, for this run or the next. *"Skip the digest today."*
* **Decision:** a standing rule, for every future run. *"Always send the digest at 9am."*

Use a message when it's temporary; use a [decision](/use/update-decision) when it's a lasting rule.

<Card title="Give standing instructions instead" icon="scroll" href="/use/standing-instructions">
  For rules that should apply every run.
</Card>