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

# Agent session tools

> Start agent sessions, send messages, inspect results, and manage conversations.

Use these tools to start agent sessions, continue conversations, and check session status.

| Tool | Description | Required inputs |
| - | - | - |
| `start_agent` | Start an asynchronous agent interaction from a message | `gummie_id`, `message` |
| `get_agent_status` | Poll an agent interaction and retrieve its completed response | `interaction_id` |
| `create_agent_session` | Start an agent session and return its completed response | `agent_id`, `message` |
| `get_session` | Fetch the state and result of an agent session by ID | `session_id` |
| `send_session_message` | Send a follow-up message and return the completed response | `session_id`, `message` |
| `cancel_session` | Cancel an in-progress agent session | `session_id` |
| `rename_session` | Rename an agent session (chat) | `session_id`, `name` |
| `list_agent_sessions` | List an agent's sessions with search, filters, sorting, and pagination | `agent_id` |

## Example prompts

<Prompt description={`Start a session with my Research Assistant agent and ask it to summarize the latest quarterly report.`} icon="comments" actions={["copy"]}>
  Start a session with my Research Assistant agent and ask it to summarize the latest quarterly report.
</Prompt>

<Prompt description={`List the recent sessions for my Research Assistant agent.`} icon="list" actions={["copy"]}>
  List the recent sessions for my Research Assistant agent.
</Prompt>

<Prompt description={`Send a follow-up to my current agent session asking for the sources it used.`} icon="reply" actions={["copy"]}>
  Send a follow-up to my current agent session asking for the sources it used.
</Prompt>

## Related

* [REST API sessions](/api-reference/sessions/list-sessions)
* [Gumloop CLI sessions](/cli/sessions)