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

# How to Launch Your First Agent

On Silvana, agents can apply defined logic to asset operations, coordinate settlement, and automate multi-step financial processes while remaining within configured execution rules.

This guide shows how to take an agent from initial setup to a working Silvana workflow, whether you start from an existing implementation or adapt one to your own use case.

# Path 1: Launch from Agent Space

Start by opening [**Agent Space**](https://app.silvana.one/agents), the catalog of agents available for use with Silvana.

1. Choose an agent from the catalog.
2. Open its details and select an available template.
3. Test the demo, when provided.
4. Copy the implementation, adjust its settings, and run it on your infrastructure.

<Tip>
  If an existing implementation matches your workflow, copy its code and adapt the configuration. Otherwise, build a custom agent with the [SDK](/sdk/sdk-intro).
</Tip>

# Path 2: Build on Silvana Book Agent

Use `cloud-agent` to configure or extend the existing [Silvana Book Agent](/sdk/silvana-book-agent) for your own trading and settlement workflows.

## 1. Install Silvana Book Agent

For workflows based on Silvana Book Agent, download the latest cloud-agent binary from [**GitHub Releases**](https://github.com/SilvanaOne/silvana-book-agent/releases/tag/v0.4.1).

Choose the archive for your platform. Checksums are provided on the release page.

Alternatively, build the CLI from source:

```shellscript theme={null}
cargo build --release -p cli
```

The compiled binary is available at:

```shellscript theme={null}
target/release/cloud-agent
```

<Note>
  Use the [**Silvana Book Agent Quickstart**](/sdk/silvana-book-agent-quickstart) for platform-specific installation commands.
</Note>

## 2. Onboard the Agent

Each new agent must complete onboarding before it can submit authenticated operations.

Run:

```shellscript theme={null}
cloud-agent onboard \
  --agent-name my-agent \
  --email me@example.com \
  --invite-code INVITE1
```

The onboarding flow registers the agent and creates the Canton party used for subsequent operations.

<Note>
  Silvana Book Agent connects to the following RPC endpoint by default:

  ```shellscript theme={null}
  https://orderbook-devnet.silvana.dev:443
  ```

  Use the --rpc option to specify another endpoint when required.
</Note>

## 3. Configure the Agent

Define the agent’s operating rules, including its markets, strategy parameters, execution cadence, limits, counterparties, RPC endpoint, and failure-handling behavior.

<Note>
  Silvana Book Agent uses `agent.toml` for its runtime configuration. Custom implementations can extend the repository or use the [SDK](/sdk/sdk-intro) and [proto definitions](https://github.com/SilvanaOne/silvana-book-agent/tree/proto/proto/silvana/ledger/v1) directly.
</Note>

## 4. Test the Workflow

Test the decision logic independently before allowing the agent to submit transactions.

<Warning>
  Verify that the agent:

  1. connects to the configured endpoint;
  2. completes onboarding successfully;
  3. retrieves balances and required service information;
  4. follows the configured markets, strategy parameters, and limits;
  5. processes order and settlement updates correctly;
  6. handles rejected or failed operations safely.
</Warning>

## 5. Run the Agent

After onboarding, configuration, and testing, run the agent on your infrastructure.

For the long-running Silvana Book Agent mode:

```shellscript theme={null}
cloud-agent agent
```

Production deployments should use secure key storage, logging, health monitoring, and a defined shutdown or kill-switch process. Configure only the operations required for the agent’s workflow.

<Note>
  For direct programmatic access to Silvana Ledger through gRPC, see the [Agentic API](/agentic-api/intro) documentation.
</Note>

<Columns cols={2}>
  <Column>
    <Card title="Silvana Book Agent Quickstart" href="/sdk/silvana-book-agent-quickstart">
      Set up and launch the agent
    </Card>

    <Card title="Configuration" href="/sdk/reference/configuration">
      Adjust runtime settings
    </Card>
  </Column>

  <Column>
    <Card title="SDK Intro" href="/sdk/sdk-intro">
      Explore the SDK
    </Card>

    <Card title="Getting Started Agentic API" href="/agentic-api/getting-started">
      Connect to the Agentic API
    </Card>
  </Column>
</Columns>