> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitagents.com/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 new instruction or piece of context. The agent picks it up the each time it checks in with Orbit.

## Steps

1. Click Instructions in the Orbits page or click the chat icon from the agent in your **Orbits Agents** list.
2. Write your instruction: *"For today's run, prioritize leads in fintech."*
3. 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.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.