> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-TW/llms.txt

# Mastra.getGateway()

依註冊鍵（將 gateway 新增到 Mastra 時使用的鍵）取得 gateway。

## 使用範例

```typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({
  gateways: {
    myGateway: new MyCustomGateway(),
  },
})

const gateway = mastra.getGateway('myGateway')
console.log(gateway.name) // 'My Custom Gateway'
```

## 參數

**key** (`string`): gateway 的註冊鍵

## 傳回值

**gateway** (`MastraModelGateway`): 該 gateway 執行個體

## 擲回錯誤

如果找不到具有指定鍵的 gateway，則擲回錯誤。

## 相關內容

- [Mastra.getGatewayById()](https://mastra.zisheng.pro/zh-TW/reference/core/getGatewayById): 依 ID 取得 gateway
- [Mastra.listGateways()](https://mastra.zisheng.pro/zh-TW/reference/core/listGateways): 列出所有 gateway
- [Mastra.addGateway()](https://mastra.zisheng.pro/zh-TW/reference/core/addGateway): 新增 gateway
- [MastraModelGateway](https://mastra.zisheng.pro/zh-TW/reference/core/mastra-model-gateway): Gateway 基類
- [自訂 Gateway 指南](https://mastra.zisheng.pro/zh-TW/models/gateways/custom-gateways): 建立自訂 gateway