# Quickstart

This section covers how to invoke Somnia Agents—calling their methods and receiving results.

## How Agent Invocation Works

Agent invocations are **asynchronous**. When you invoke an agent:

1. Your request is sent to the Somnia network
2. Multiple validator nodes execute the agent independently
3. Validators reach consensus on the result
4. The result is returned (and optionally delivered to a callback)

{% @mermaid/diagram content="sequenceDiagram
participant You
participant Platform as Platform Contract
participant Network as Validator Network

```
You->>Platform: Invoke agent + fee
Platform->>Network: Distribute to validators
Network->>Network: Execute & reach consensus
Network->>Platform: Return result
Platform->>You: Deliver result (callback or response)" %}
```

This decentralized execution ensures that results are trustworthy and auditable.

## Network & Tokens

Somnia Agents are live on both **Somnia Mainnet** and **Somnia Testnet**. Pick the network that matches your deployment target:

| Property                | Mainnet                                      | Testnet                                      |
| ----------------------- | -------------------------------------------- | -------------------------------------------- |
| Network Name            | Somnia Mainnet                               | Somnia Testnet                               |
| Chain ID                | `5031`                                       | `50312`                                      |
| RPC URL                 | `https://api.infra.mainnet.somnia.network`   | `https://api.infra.testnet.somnia.network`   |
| Currency                | SOMI                                         | STT                                          |
| `SomniaAgents` Contract | `0x5E5205CF39E766118C01636bED000A54D93163E6` | `0x037Bb9C718F3f7fe5eCBDB0b600D607b52706776` |

Get testnet STT from the [Somnia Faucet](https://testnet.somnia.network). For mainnet, acquire SOMI through the usual channels.

## Explore Agents

The easiest way to get started is the Agent Explorer web app:

| Network | URL                                                                                |
| ------- | ---------------------------------------------------------------------------------- |
| Testnet | [**https://agents.testnet.somnia.network**](https://agents.testnet.somnia.network) |
| Mainnet | [**https://agents.somnia.network**](https://agents.somnia.network)                 |

Here you can:

* Browse all available agents
* View agent methods and their parameters
* Invoke agents directly from the browser
* View execution receipts
* Generate code snippets for Solidity and JavaScript

## Invocation Methods

There are two ways to invoke agents:

| Method       | Use Case                                        | Guide                                                              |
| ------------ | ----------------------------------------------- | ------------------------------------------------------------------ |
| **Web App**  | Exploration, testing, one-off calls             | This page                                                          |
| **Solidity** | Smart contract integration, on-chain automation | [Invoking from Solidity](/agents/invoking-agents/from-solidity.md) |

All agent invocations go through the Solidity platform contract — including calls made from the web app.

## Next Steps

* [Invoking from Solidity](/agents/invoking-agents/from-solidity.md) — Integrate agents into smart contracts
* [Receipts](/agents/invoking-agents/receipts.md) — Understand execution receipts
* [Gas Fees](/agents/invoking-agents/gas-fees.md) — Learn about invocation costs


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.somnia.network/agents/invoking-agents/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.