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

# IBM WatsonX

> 了解如何在 Agno 中使用 IBM WatsonX 模型。

IBM WatsonX 通过 IBM 的云平台提供强大的基础模型访问。

在此处查看所有 IBM WatsonX 支持的模型：[https://www.ibm.com/products/watsonx-ai/foundation-models](https://www.ibm.com/products/watsonx-ai/foundation-models)。

* 我们建议将 `meta-llama/llama-3-3-70b-instruct` 用于通用任务
* 我们建议将 `ibm/granite-20b-code-instruct` 用于代码相关任务
* 我们建议将 `meta-llama/llama-3-2-11b-vision-instruct` 用于图像理解

#### 多模态支持

通过 WatsonX，我们支持 `Image`（图像）作为输入

## 身份验证

设置您的 `IBM_WATSONX_API_KEY` 和 `IBM_WATSONX_PROJECT_ID` 环境变量。从 [IBM Cloud](https://cloud.ibm.com/) 获取您的凭据。
您也可以设置 `IBM_WATSONX_URL` 环境变量为要使用的 WatsonX API 的 URL。它默认为 `https://eu-de.ml.cloud.ibm.com`。

<CodeGroup>
  ```bash Mac theme={null}
  export IBM_WATSONX_API_KEY=***
  export IBM_WATSONX_PROJECT_ID=***
  ```

  ```bash Windows theme={null}
  setx IBM_WATSONX_API_KEY ***
  setx IBM_WATSONX_PROJECT_ID ***
  ```
</CodeGroup>

## 示例

在您的 `Agent` 中使用 `WatsonX`：

<CodeGroup>
  ```python agent.py theme={null}
  from agno.agent import Agent, RunResponse
  from agno.models.ibm import WatsonX

  agent = Agent(
      model=WatsonX(id="meta-llama/llama-3-3-70b-instruct"),
      markdown=True
  )

  # 在终端中打印响应
  agent.print_response("写一个两句话的恐怖故事。")

  ```
</CodeGroup>

<Note> 在此处查看更多示例：[../examples/models/ibm](../examples/models/ibm) </Note>

## 参数

<Snippet file="model-ibm-watsonx-params.mdx" />

`WatsonX` 是 `Model` [类](/reference/models/model) 的子类，可以访问相同的参数。