Skip to content

Azure AI 搜索凭据#

¥Azure AI Search credentials

你可以使用以下凭据验证以下节点：

¥You can use these credentials to authenticate the following nodes:

¥Azure AI Search Vector Store

先决条件#

¥Prerequisites

¥An Azure subscription

¥An Azure AI Search service created in the Azure Portal

支持的身份验证方法#

¥Supported authentication methods

此节点使用 API 密钥进行身份验证。

¥This node uses API key authentication.

相关资源#

¥Related resources

有关服务的更多信息，请参阅 Azure AI 搜索文档。

¥Refer to Azure AI Search documentation for more information about the service.

使用 API 密钥#

¥Using API key

要配置此凭据，你需要：

¥To configure this credential, you'll need:

  • 端点：你的 Azure AI 搜索服务 URL（格式：https://your-service.search.windows.net）

¥Endpoint: Your Azure AI Search service URL (format: https://your-service.search.windows.net)

  • API 密钥：管理员密钥（读写）或查询密钥（只读）

¥API Key: Admin key (read-write) or query key (read-only)

获取这些值：

¥To get these values:

  1. 导航至你的 Azure AI 搜索服务。 Azure 门户

¥Navigate to your Azure AI Search service in the Azure Portal 2. 从“概览”部分复制 URL。

¥Copy the URL from the Overview section 3. 前往“设置”>“密钥”并复制：

¥Go to Settings > Keys and copy:

  • 管理员密钥提供完整的读写权限，或

    ¥Admin key for full read-write access, or

  • 用于只读查询的查询键

    ¥Query key for read-only querying 4. 在 n8n 中输入以下值：

¥Enter these values in n8n

API key permissions

管理员密钥提供完整的访问权限，包括索引的创建和删除。查询键提供只读访问权限。根据你的工作流程需求进行选择。

¥Admin keys provide full access including index creation and deletion. Query keys provide read-only access. Choose based on your workflow requirements.

故障排除#

¥Troubleshooting

身份验证错误#

¥Authentication errors

API 密钥身份验证失败：

¥API key authentication fails:

  • 验证 API 密钥是否正确，且未在 Azure 门户中重新生成。

¥Verify the API key is correct and hasn't been regenerated in Azure Portal

  • 确认你使用管理员密钥进行写入操作（插入/更新）

¥Confirm you're using an admin key for write operations (insert/update)

  • 检查密钥是否已过期或轮换。

¥Check that the key hasn't expired or been rotated

连接问题#

¥Connection issues

  • 验证端点 URL 格式：https://your-service.search.windows.net

¥Verify endpoint URL format: https://your-service.search.windows.net

  • 确认你的 Azure AI 搜索服务正在运行

¥Confirm your Azure AI Search service is running

  • 检查网络安全规则和防火墙设置是否允许你的 n8n 实例访问

¥Check network security rules and firewall settings allow access from your n8n instance