Agent Platform SDK for Python 简介

借助 Python 版 Agent Platform SDK,您可以在 Gemini Enterprise Agent Platform 中自动数据注入、训练模型,并获取预测结果。Agent Platform SDK 通过 Python 代码来访问 Agent Platform API,让您能以编程方式完成可在 Google Cloud 控制台中执行的大部分操作。

如需了解如何安装或更新 Agent Platform SDK for Python,请参阅安装 Agent Platform SDK for Python。如需了解详情,请参阅 Agent Platform SDK for Python API 参考文档

为何使用 Agent Platform SDK

如果您是经验丰富的机器学习 (ML) 及人工智能 (AI) 工程师或是希望以编程方式自动执行工作流的数据科学家,则推荐您使用 Agent Platform SDK for Python。Agent Platform SDK for Python 与 Gemini Enterprise Agent Platform Python 客户端库类似,只不过 Agent Platform SDK 内容更具概括性,没有那么细化。如需了解详情,请参阅了解 SDK 和客户端库的区别

使用 Agent Platform SDK for Python 编写代码

如需使用 Agent Platform SDK for Python,请执行以下操作:

  1. 在虚拟环境中运行以下命令,安装 google-cloud-aiplatform 软件包(其中包含 Agent Platform SDK for Python 和 Gemini Enterprise Agent Platform Python 客户端库):

    pip install --upgrade google-cloud-aiplatform
    
  2. 使用以下代码导入 google.cloud.aiplatform 命名空间:

    from google.cloud import aiplatform
    

  3. 如果您使用的是本地 shell,请为您的用户账号创建本地身份验证凭证:

    gcloud auth application-default login

    如果您使用的是 Cloud Shell,则无需执行此操作。

    如果系统返回身份验证错误,并且您使用的是外部身份提供方 (IdP),请确认您已 使用联合身份登录 gcloud CLI

了解 Agent Platform SDK for Python

请参阅以下文档:

试用代码示例和教程

这些笔记本教程介绍了如何在较大的工作流中使用 Agent Platform SDK for Python。如需了解详情,请参阅 Gemini Enterprise Agent Platform 笔记本教程

Agent Platform SDK for Python GitHub 代码库中的代码示例展示如何完成各项任务。如需了解详情,请参阅 Agent Platform SDK for Python GitHub 代码库

了解 Agent Platform SDK 与其客户端库之间的差异

安装 Agent Platform SDK for Python 时,会同时安装 Gemini Enterprise Agent Platform Python 客户端库。Agent Platform SDK 和 Gemini Enterprise Agent Platform Python 客户端库具有粒度级别不同的类似功能。代理平台 SDK 以比客户端库更高的抽象层运行,适合大多数常见的数据科学工作流。如果您需要较低级别的功能,请使用 Gemini Enterprise Agent Platform Python 客户端库。

Agent Platform SDK 适用于 Python,Gemini Enterprise Agent Platform 客户端库适用于 Python、Java 和 Node.js。如需了解如何安装 Java 或 Node.js 客户端库,请参阅安装 Gemini Enterprise Agent Platform 客户端库。如果您的首选编程语言不支持客户端库,则可以使用 Gemini Enterprise Agent Platform REST API。如需了解详情,请参阅 Gemini Enterprise Agent Platform REST 参考文档

结合使用 Gemini Enterprise Agent Platform Python 客户端库和 SDK

如果您使用 Agent Platform SDK for Python,并且发现需要更大的灵活性或控制力,或者需要 Agent Platform SDK 中未包含的方法,则可以在同一工作流中使用 Gemini Enterprise Agent Platform Python 客户端库。Gemini Enterprise Agent Platform Python 客户端库使用不同的命名空间来访问 Agent Platform API。您可以在同一 Python 脚本中使用客户端库命名空间和 Agent Platform SDK for Python 命名空间,只需在 Python 脚本中为这两者各添加一行 import 内容即可。

导入 Gemini Enterprise Agent Platform Python 客户端库命名空间

Gemini Enterprise Agent Platform Python 客户端库命名空间为 google.cloud.aiplatform.gapic。此命名空间映射到 google.cloud.aiplatform_v1 命名空间。这两个命名空间可以互换使用。如需导入 Python 客户端库,请在 Python 脚本中添加以下任一项:

from google.cloud import aiplatform_v1
from google.cloud.aiplatform import gapic

后续步骤