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

# Mastra.getAgent()

`.getAgent()` 方法用於取得 Agent。此方法接受一個 `string` 參數，用於指定 Agent 名稱。

## 使用範例

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

## 參數

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

## 傳回值

**agent** (`TAgents[TAgentName]`): 具有指定名稱的 Agent 執行個體。如果找不到該 Agent，則擲回錯誤。

## 相關內容

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