创建 AI 服务连接文件 (数据管理)—ArcGIS Pro

摘要

创建托管 AI 服务的连接文件。

使用情况

此工具消除了每次与 AI 服务交互时手动提供访问凭据和配置设置的需要。这确保了更快、更安全的连接过程，同时降低了配置错误的风险。
此工具以编码格式保存连接详细信息，确保安全处理敏感信息。
您必须提供文件夹位置并为连接文件指定文件名，该文件将以 .ais 格式保存。
该工具支持多个基于云的 AI 服务提供商。
保存的连接文件可以在各种任务中重复使用，从而减少了重复身份验证的需要。

参数

标注	说明	数据类型
连接文件位置	将在其中创建连接文件的文件夹路径。	Folder
连接文件名称	AI 服务连接文件名。	String
服务提供商	指定将使用的云服务提供商。 AWS - 云服务提供商将是 Amazon Web Services (AWS)。AWS 提供一套全面的基于云的机器学习和 AI 服务，支持可扩展的 AI 模型部署和数据处理。 Anthropic - 云服务提供商将是 Anthropic。 Anthropic 专注于开发以安全性和对齐为重点的 AI 系统，提供最新的道德 AI 模型。 Azure - 云服务提供商将是 Microsoft Azure。Microsoft Azure 提供基于云的 AI 工具和服务，包括预训练模型和面向企业的定制 AI 解决方案。 Hugging Face - 云服务提供商将是 Hugging Face。 Hugging Face 提供广泛的预训练机器学习模型和 AI 解决方案库，专注于自然语言处理。 OpenAI - 云服务提供商将是 OpenAI。 OpenAI 为各种应用提供先进的 AI 模型，如文本生成和图像创建。 Google - 云服务提供商将是 Google Cloud AI。 Google Cloud AI 提供广泛的 AI 和机器学习服务，包括 TensorFlow、预训练模型和面向各个行业的定制解决方案。 Others - 此类包括提供针对各个领域专业 AI 模型和服务的其他云服务提供商。	String
连接参数	将添加到输出连接文件中的连接参数。键和值对于每个服务提供商都是唯一的。键 - 连接参数键的名称。值 - 连接参数键的值。	Value Table
密钥参数键 (可选)	其值包含敏感信息（如 API 密钥或身份验证令牌）的键。	String
密钥参数值 (可选)	用于验证连接的密钥访问键字符串。警告：这是敏感信息，应仅与受信任的服务提供商共享。所提供的键存储在 Windows 凭据管理器中，且相应的服务名称 (GUID) 保存在输出文件中。	String Hidden

派生输出

标注	说明	数据类型
输出连接文件	输出连接文件的路径。	File

arcpy.management.CreateAIServiceConnectionFile(out_folder_path, out_name, service_provider, connection_parameters, {secret_param_key}, {secret_param_value})

名称	说明	数据类型
out_folder_path	将在其中创建连接文件的文件夹路径。	Folder
out_name	AI 服务连接文件名。	String
service_provider	指定将使用的云服务提供商。 AWS - 云服务提供商将是 Amazon Web Services (AWS)。AWS 提供一套全面的基于云的机器学习和 AI 服务，支持可扩展的 AI 模型部署和数据处理。 Anthropic - 云服务提供商将是 Anthropic。 Anthropic 专注于开发以安全性和对齐为重点的 AI 系统，提供最新的道德 AI 模型。 Azure - 云服务提供商将是 Microsoft Azure。Microsoft Azure 提供基于云的 AI 工具和服务，包括预训练模型和面向企业的定制 AI 解决方案。 Hugging Face - 云服务提供商将是 Hugging Face。 Hugging Face 提供广泛的预训练机器学习模型和 AI 解决方案库，专注于自然语言处理。 OpenAI - 云服务提供商将是 OpenAI。 OpenAI 为各种应用提供先进的 AI 模型，如文本生成和图像创建。 Google - 云服务提供商将是 Google Cloud AI。 Google Cloud AI 提供广泛的 AI 和机器学习服务，包括 TensorFlow、预训练模型和面向各个行业的定制解决方案。 Others - 此类包括提供针对各个领域专业 AI 模型和服务的其他云服务提供商。	String
connection_parameters [connection_parameters,...]	将添加到输出连接文件中的连接参数。键和值对于每个服务提供商都是唯一的。键 - 连接参数键的名称。值 - 连接参数键的值。	Value Table
secret_param_key (可选)	其值包含敏感信息（如 API 密钥或身份验证令牌）的键。	String
secret_param_value (可选)	用于验证连接的密钥访问键字符串。警告：这是敏感信息，应仅与受信任的服务提供商共享。所提供的键存储在 Windows 凭据管理器中，且相应的服务名称 (GUID) 保存在输出文件中。	String Hidden

派生输出

名称	说明	数据类型
out_connection_file	输出连接文件的路径。	File

代码示例

CreateAIServiceConnectionFile（独立脚本）

以下示例演示了如何使用 CreateAIServiceConnectionFile 函数。

# Description: This tool generates and stores secure connection files for accessing hosted AI services.
#
# Requirements: ArcGIS Pro Basic license

# Import system modules
import arcpy

# Set local variables
out_folder_path = r"path_to_output_folder"
out_name = "ConnectionFile"
service_provider = "Azure"
connection_parameters = "'EndPoint URI' https://test.domain.com/;'Deployment Name' Test;'Model Name' test;'API Version' 2024-02-15"
secret_param_key = "Key"
secret_param_value = "RandomKey"

# Run Create AI Service Connection File
arcpy.management.CreateAIServiceConnectionFile(
    out_folder_path=out_folder_path, out_name=out_name,
    service_provider=service_provider,
    connection_parameters=connection_parameters,
    secret_param_key=secret_param_key,
    secret_param_value=secret_param_value
)

环境

处理器类型, GPU ID

许可信息

Basic: 是
Standard: 是
Advanced: 是

摘要

使用情况

参数

警告：

派生输出

警告：

派生输出

代码示例

环境

许可信息

相关主题

在本主题中