---
title: "Agent 一键入驻"
method: POST
path: "/api/v1/agent/setup"
tags: ["Agent Onboarding"]
---

# Agent 一键入驻

`POST /api/v1/agent/setup`

## Request

- Base URL: `https://aishield.tools`
- URL: `https://aishield.tools/api/v1/agent/setup`
- Auth: none required

Agent 一键入驻：一次调用完成 Agent 注册 + API Key 生成 + 快速开始指引。

无需认证。返回的 `api_key` 仅在响应中出现一次，请妥善保存。

## Request body

- AgentSetupRequest: Agent 一键入驻请求
  - `agent_name` string, required: Agent 名称
  - `capabilities` string[]: Agent 能力列表
  - `owner` string: 所有者标识（可选）

## Response `201`

Agent 入驻成功

- AgentSetupResponse: Agent 一键入驻结果
  - `success` boolean
  - `agent` object: Agent 注册信息
    - `did` string: 去中心化身份标识（did:key 自认证身份）
    - `name` string
    - `capabilities` string[]
    - `reputation_score` integer
    - `status` string
    - `registered_at` string, date-time
  - `api_key` string: API 密钥（明文，仅返回一次）
  - `key_id` string: API 密钥 ID
  - `base_url` string
  - `mcp_endpoint` string
  - `quick_start` object: 各能力的快速开始指引
    - `scan` string: 安全扫描调用方式
    - `prompt_check` string: Prompt 检测调用方式
    - `mcp` string: MCP 协议对接方式

## Other responses

- `400`: 参数缺失或无效
- `409`: Agent 已存在（DID 冲突）
- `500`: 内部错误

---

[API](https://skmtc.dev/aishield/apis/aishield-api.md) · [All operations](https://skmtc.dev/aishield/apis/aishield-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aishield/apis/aishield-api/revisions/9a04f4fb94bd?raw)