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

# 从 Marketplace 安装插件

> 从 LangBot Marketplace 安装插件。异步操作，返回任务 ID。



## OpenAPI

````yaml /openapi/service-api-ja.json post /api/v1/plugins/install/marketplace
openapi: 3.0.3
info:
  title: LangBot Service API
  description: >
    LangBot external service API documentation. These endpoints support API Key
    authentication for programmatic access to LangBot resources.


    **Authentication:**

    - User Token (via `Authorization: Bearer <token>`)

    - API Key (via `X-API-Key: <key>` or `Authorization: Bearer <key>`)


    All endpoints in this document support both authentication methods unless
    otherwise noted.
  version: 4.9.5
  contact:
    name: LangBot
    url: https://langbot.app
  license:
    name: AGPL-3.0
    url: https://github.com/langbot-app/LangBot/blob/master/LICENSE
servers:
  - url: http://localhost:5300
    description: Local development server
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: モデルプロバイダー
    description: >-
      Model provider management. Providers define API endpoints and keys; models
      reference providers via provider_uuid.
  - name: LLMモデル
    description: >-
      Large Language Model (LLM) management. Each model is associated with a
      provider.
  - name: 埋め込みモデル
    description: Embedding model management. Each model is associated with a provider.
  - name: ボット
    description: Bot instance management and messaging
  - name: パイプライン
    description: Pipeline configuration management
  - name: ナレッジベース
    description: Knowledge base management
  - name: ナレッジエンジン
    description: Knowledge engine (plugin-provided) queries
  - name: パーサー
    description: File parser (plugin-provided) queries
  - name: ファイル
    description: File upload operations
  - name: プラグイン
    description: Plugin installation, configuration, and management
  - name: システム
    description: System information (no auth required)
paths:
  /api/v1/plugins/install/marketplace:
    post:
      tags:
        - Plugins
      summary: 从 Marketplace 安装插件
      description: 从 LangBot Marketplace 安装插件。异步操作，返回任务 ID。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - plugin_id
              properties:
                plugin_id:
                  type: string
                  description: Marketplace 插件 ID（author/name 格式）
                  example: kellz-dev/disaster-alert
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 0
                  data:
                    type: object
                    properties:
                      task_id:
                        type: integer
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer

````