> ## Documentation Index
> Fetch the complete documentation index at: https://ai-gateway.juniortree.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 集成指南

> 了解如何将AI Gateway集成到您的项目中，实现多AI平台的统一管理

## 集成概述

AI Gateway 设计为即插即用的解决方案，可以轻松集成到现有的项目中。通过统一的API接口，您可以同时管理多个AI平台，实现灵活的服务切换和成本优化。

## 集成优势

### 统一接口管理

AI Gateway 提供标准化的API接口，无论您使用哪个AI平台，都可以使用相同的请求格式和响应结构。

<CardGroup cols={2}>
  <Card title="简化前端开发" icon="code">
    前端只需对接一套API，无需为每个AI平台编写不同的集成代码
  </Card>

  <Card title="降低维护成本" icon="wrench">
    统一的接口减少了代码重复，降低了系统的维护复杂度
  </Card>
</CardGroup>

### 灵活的平台切换

通过简单的请求头参数，您可以轻松切换不同的AI平台，无需修改前端代码。

<Info>
  只需要在请求头中指定 `agent` 参数，即可切换到不同的AI平台，比如：

  * `agent: fastgpt` - 使用FastGPT服务
  * `agent: dify` - 使用Dify服务
  * `agent: coze` - 使用Coze服务
</Info>

### 成本优化策略

AI Gateway 支持多平台并行使用，您可以根据不同场景选择最优的AI平台。

<CardGroup cols={2}>
  <Card title="性能对比" icon="chart-line">
    可以实时比较不同平台的响应速度和准确性
  </Card>

  <Card title="成本控制" icon="dollar-sign">
    根据使用量选择最经济的AI平台，优化成本结构
  </Card>
</CardGroup>

## 核心功能集成

### 聊天对话功能

AI Gateway 提供统一的聊天接口，支持多种对话模式：

* **标准对话** - 基础的问答功能
* **流式对话** - 实时流式响应，提升用户体验
* **上下文对话** - 支持多轮对话和上下文保持
* **多模态对话** - 支持文本、图片、文档等多种输入

<Tip>
  流式对话特别适合长文本生成场景，可以提供更好的用户体验
</Tip>

### 文件处理功能

统一的文件上传和处理接口，支持多种文件类型：

* **文档处理** - PDF、Word、Excel等文档格式
* **图片处理** - JPG、PNG等图片格式
* **批量上传** - 支持多文件同时上传
* **存储管理** - 根据接入 Agent 的存储方式，存储到相应的存储服务

<Warning>
  文件大小限制为10MB，支持的文件类型包括：.txt, .pdf, .doc, .docx, .jpg, .png
</Warning>

### 知识库集成

通过FastGPT Agent，您可以轻松集成自定义知识库：

* **知识库检索** - 基于向量数据库的智能检索
* **引用溯源** - 自动提供信息来源和引用
* **知识更新** - 支持知识库的动态更新
* **多知识库** - 支持多个知识库的并行使用

## 部署集成

## 扩展集成

### 自定义Agent开发

AI Gateway 采用插件化架构，支持自定义Agent开发：

<Steps>
  <Step title="继承基类">
    创建新的Agent类，继承BaseAgent基类
  </Step>

  <Step title="实现接口">
    实现必要的抽象方法，包括chat和upload\_file
  </Step>

  <Step title="注册Agent">
    将新Agent注册到Agent注册表中
  </Step>

  <Step title="配置环境">
    配置相应的环境变量和参数
  </Step>
</Steps>

<Card title="查看API文档" icon="terminal" href="/api-reference/introduction">
  了解完整的API接口文档和使用示例
</Card>