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

# Mastra.getAgent()

`.getAgent()` 方法用於擷取 Agent。此方法接受一個代表 Agent 名稱的 `string` 參數。

## 使用範例

```typescript
mastra.getAgent('testAgent')
```

## 參數

**name** (`TAgentName extends keyof TAgents`): 要擷取的 Agent 名稱。必須是 Mastra 配置中存在的有效 Agent 名稱。

## 傳回值

**agent** (`TAgents[TAgentName]`): 具有指定名稱的 Agent 實例。如找不到 Agent，便會拋出錯誤。

## 相關內容

- [Agent 概覽](https://mastra.zisheng.pro/zh-HK/docs/agents/overview)