> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 建立代理
> 建立一個具有 MPC 安全錢包的新 AI 代理。
建立一個新代理，並自動配置 MPC 安全錢包。錢包地址使用分散式金鑰生成（DKG）產生，可立即接收資金。
## 請求主體
代理的顯示名稱。必須在您的帳戶中唯一。
代理用途的可選說明。
代理錢包的 CAIP-2 鏈識別碼。請參閱[支援的區塊鏈](/zh-Hant/platform/supported-chains)了解可用選項。
範例：`eip155:1`（Ethereum）、`eip155:8453`（Base）、`eip155:84532`（Base Sepolia 測試網）
JSON 編碼的中繼資料字串，用於自訂鍵值對。
## 回應
唯一代理識別碼（例如 `agent_abc123`）。
代理顯示名稱。
鏈上錢包地址。
CAIP-2 鏈識別碼。
代理狀態：`active` 或 `inactive`。
ISO 8601 建立時間戳記。
## 範例
```bash cURL theme={null}
curl -X POST https://api.agentwallex.com/api/v1/agents \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"agent_name": "research-bot",
"agent_description": "Market research automation agent",
"chain": "eip155:84532",
"metadata": "{\"team\":\"growth\"}"
}'
```
```typescript TypeScript theme={null}
const agent = await aw.agents.create({
name: "research-bot",
chain: "eip155:84532",
metadata: { team: "growth" },
});
```
```python Python theme={null}
agent = await aw.agents.create(
name="research-bot",
chain="eip155:84532",
metadata={"team": "growth"},
)
```
```json Response theme={null}
{
"id": "agent_abc123",
"agent_name": "research-bot",
"agent_description": "Market research automation agent",
"wallet": {
"address": "0x1234567890abcdef1234567890abcdef12345678",
"chain": "eip155:84532"
},
"status": "active",
"created_at": "2025-06-01T10:00:00Z"
}
```
## OpenAPI
````yaml POST /api/v1/agents
openapi: 3.1.0
info:
title: AgentWallex API
description: >-
REST API for managing AI agent wallets, on-chain transactions, spending
policies, webhooks, and x402 micropayments.
version: 1.0.0
contact:
name: AgentWallex Support
url: https://agentwallex.com
servers:
- url: https://api.agentwallex.com
description: Production
- url: https://api-sandbox.agentwallex.com
description: Sandbox
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Agents
description: Create and manage AI agent wallets.
- name: Transactions
description: Send payments and query transaction history.
- name: Policies
description: Configure spending limits and access controls.
- name: Webhooks
description: Register and manage webhook endpoints.
- name: x402
description: x402 micropayment negotiation and session management.
paths:
/api/v1/agents:
post:
tags:
- Agents
summary: Create Agent
description: >-
Create a new agent with an automatically provisioned MPC-secured wallet.
The wallet address is generated using Distributed Key Generation (DKG)
and is ready to receive funds immediately.
operationId: createAgent
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- agent_name
- chain
properties:
agent_name:
type: string
description: >-
Display name for the agent. Must be unique within your
account.
agent_description:
type: string
description: Optional description of the agent's purpose.
chain:
type: string
description: >-
CAIP-2 chain identifier for the agent's wallet (e.g.,
`eip155:1` for Ethereum, `eip155:8453` for Base,
`eip155:84532` for Base Sepolia testnet).
metadata:
type: string
description: JSON-encoded metadata string for custom key-value pairs.
example:
agent_name: research-bot
agent_description: Market research automation agent
chain: eip155:84532
metadata: '{"team":"growth"}'
responses:
'200':
description: Agent created successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/Agent'
example:
id: agent_abc123
agent_name: research-bot
agent_description: Market research automation agent
wallet:
address: '0x1234567890abcdef1234567890abcdef12345678'
chain: eip155:84532
status: active
created_at: '2025-06-01T10:00:00Z'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
Agent:
type: object
description: An AI agent with an MPC-secured wallet.
properties:
id:
type: string
description: Unique agent identifier (e.g., `agent_abc123`).
agent_name:
type: string
description: Agent display name.
agent_description:
type: string
description: Agent description.
wallet:
$ref: '#/components/schemas/Wallet'
status:
type: string
enum:
- active
- inactive
description: Agent status.
metadata:
type: string
description: JSON-encoded metadata string.
created_at:
type: string
format: date-time
description: ISO 8601 creation timestamp.
Wallet:
type: object
description: An on-chain wallet associated with an agent.
properties:
address:
type: string
description: On-chain wallet address.
chain:
type: string
description: CAIP-2 chain identifier.
ErrorResponse:
type: object
description: Standard error response.
required:
- code
- type
- message
properties:
code:
type: string
description: Machine-readable error code.
type:
type: string
enum:
- invalid_request_error
- authentication_error
- authorization_error
- not_found_error
- rate_limit_error
- internal_error
description: Error type category.
message:
type: string
description: Human-readable error description.
responses:
BadRequest:
description: Invalid request body or parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: invalid_request
type: invalid_request_error
message: The request body is missing required fields.
Unauthorized:
description: Missing or invalid credentials.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: authentication_failed
type: authentication_error
message: The provided API key is invalid or expired.
Forbidden:
description: Insufficient permissions.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: insufficient_permissions
type: authorization_error
message: You do not have permission to perform this action.
RateLimited:
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: rate_limit_exceeded
type: rate_limit_error
message: Too many requests. Please retry after a short delay.
InternalError:
description: Server-side error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: server_error
type: internal_error
message: An unexpected error occurred. Please try again later.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key authentication. Keys are prefixed with `awx_`.
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT bearer token authentication.
````