> For the complete documentation index, see [llms.txt](https://docs.sat20.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sat20.org/english/learn-understanding-satoshinet/ai-agent.md).

# AI Agents and User Asset Control

AI Agents are not an accessory to SAT20. They may become an important interface for ordinary users interacting with STP, SatoshiNet, and smart contracts.

STP, RSMC, commitment transactions, punishment transactions, indexer evidence, and cross-layer asset state are complex for most users. The value of an Agent is that it can read this evidence and translate complex protocols into executable, explainable, and verifiable user operations.

## Agent Responsibilities

An Agent is responsible for:

1. Understanding the user's goal.
2. Querying wallet, channel, L1/L2 transactions, and indexers.
3. Reviewing asset facts, confirmations, spent state, and cross-layer evidence.
4. Judging the current safety state.
5. Calling a wallet adapter.
6. Explaining what each step does.
7. Stopping when the state is unsafe.

Agent boundaries:

1. It does not store user mnemonic phrases.
2. It does not bypass wallet authorization.
3. It stops value movement when punish coverage cannot be proven.
4. It does not treat Core Node verbal status as a safety proof.

## Skill Model

SAT20 provides the SAT20 Agent Wallet skill so Agents can operate wallets and Core Nodes through a unified JSON adapter.

Recommended order:

1. The user first installs [SAT20 PWA Wallet](https://sat20.org/pwa/?install=1).
2. The user creates or imports a wallet inside the PWA, completes backup, unlocks it, and selects the network.
3. The Agent then installs SAT20 Agent Wallet skill and calls the wallet through the PWA adapter.
4. The Agent first runs `wallet.status`, `stp.status`, and `stp.safety_snapshot` before moving assets.

Install the skill:

```bash
curl -fsSL https://raw.githubusercontent.com/sat20-labs/docs/main/ai/sat20-agent-wallet/skills/sat20-agent-wallet/scripts/install.sh | bash
```

The canonical skill source lives in the Chinese `sat20-labs/docs` repository. English documentation links to that source instead of copying a separate skill tree.

More details: [SAT20 Agent Wallet: Install and Use](/english/ai-agent-automation-and-safety/sat20-agent-wallet/sat20-agent-wallet.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.sat20.org/english/learn-understanding-satoshinet/ai-agent.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.