在 Server 上使用 AI 工具
使用服务主体在 Server 上设置和运行 AI 工具。使用本指南在 Alteryx One 中创建服务主体并连接您的 AI 工具。有关 Alteryx One 中的服务主体的详细信息,请转至服务主体页面。
要求
需由 工作区管理员 创建和管理服务主体。
您必须是 完整用户 或具有生成式 AI 工具功能的自定义角色才能使用 AI 工具。
必须为 Server 启用 AMP。管理员必须从系统设置中启用 AMP。如需详细了解 AMP 和 Server,请转至 AMP Engine 最佳实践。
首次设置
只需完成一次这些步骤,即可允许 AI 工具使用 Alteryx One 中的 LLM 连接。
在 Alteryx One 中创建服务主体
注意
您必须是 工作区管理员 才能完成此步骤。
在 Alteryx One 中,打开配置文件菜单。
转至工作区管理 > 服务主体。
选择新建。
输入值:
名称:输入一个唯一名称。
描述:输入描述。
私密密钥生命周期(天):输入 1 到 365 之间的值。
在角色中,选择具有生成式 AI 工具功能的 完整用户 角色或自定义角色。
点击创建。
创建服务主体之后:
复制客户端 ID。
复制客户端私密密钥。
安全存储这些值。
在 Alteryx One 中共享 LLM 连接
转至数据。
选择连接。
找到 LLM 连接。
选择三点菜单,然后选择共享。
从选择用户或服务主体中,选择服务主体。
在角色下拉列表中,选择编辑者(或所需角色)。
将凭证共享设置为共享凭证。
选择共享。
在 Designer 中配置提示词或 LLM 覆盖工具
选择服务主体连接
在 Designer 中,打开工作流。
选择提示词工具。
在连接选项部分中,选择服务主体(用于 Server)。
创建连接
选择创建新连接。
在数据连接管理器 (DCM) 中,选择 + 新建。
在选择技术下拉列表中,选择 Alteryx One OAuth 应用程序。
输入凭证
注意
要输入这些凭证,请确保您有权访问服务主体的客户端 ID 和客户端私密密钥。如果您没有创建服务主体,请要求 工作区管理员 提供这些值。
在数据源名称中,输入名称。
在客户端 ID 中,输入服务主体客户端 ID。
在客户端私密密钥中,输入服务主体客户端私密密钥。
选择保存。
将工作流发布到 Server
配置服务主体连接后,将工作流发布到 Server。
工作流在 Server 上使用服务主体运行。AI 工具使用共享 LLM 连接,无需用户身份验证即可运行。
轮换服务主体私密密钥
服务主体的客户端私密密钥在 1 年后过期。当私密密钥过期时,请在数据连接管理器中使用新的客户端私密密钥更新服务主体连接。如需详细了解私密密钥轮换,请转至服务主体页面。
注意
如果您未创建服务主体,请让 工作区管理员 提供新的客户端私密密钥。
生成新的客户端私密密钥
从 Alteryx One 中,转至工作区管理 > 服务主体。
在“服务主体”页面上,选择服务主体以打开其详细信息页面。
选择生成私密密钥。
复制并安全存储新私密密钥。
在 Designer Desktop 中更新连接
在 Designer Desktop 中,选择文件 > 管理连接。
在“连接”页面上,选择服务主体连接。
选择编辑。
输入客户端私密密钥,然后选择保存。
在工作流中使用连接之前,请检查连接以确保其按预期工作。