技能 azure-search-documents-py
📦
azure-search-documents-py
内容修订 r2 安全 ⚡ 包含脚本⚙️ 外部命令🌐 网络访问🔑 环境变量
使用 Python 构建 Azure AI Search 应用
Azure AI Search 项目需要针对索引、查询、向量和扩充的正确 SDK 模式。此技能提供实用的 Python 示例，用于构建和运行搜索工作流。
支持: Claude Codex Code(CC)
使用我的智能体安装
将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。
智能体请求
Review the Skillstore skill "azure-search-documents-py" from https://skillstore.io/skills/sickn33-azure-search-documents-py.md and its manifest at https://skillstore.io/api/skills/sickn33-azure-search-documents-py/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智能体仍应展示其计划，并按安全策略请求必要确认。
Agent 可读资源
当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。
测试它
正在使用“azure-search-documents-py”。 我需要使用文本和嵌入查询 Azure AI Search 索引。
预期结果:
一个混合检索计划，说明客户端设置、向量查询构造、选定字段、筛选器、结果限制和语义排序选项。
正在使用“azure-search-documents-py”。 我需要为带有嵌入的文档创建一个新索引。
预期结果:
一个面向 Python 的索引设计，包含关键字段、可搜索文本字段、嵌入字段、向量配置文件设置和语义配置指导。
正在使用“azure-search-documents-py”。 我需要为搜索客户端提供更安全的生产身份验证。
预期结果:
建议使用 DefaultAzureCredential，定义必需的环境设置，尽可能避免生产环境 API 密钥，并在部署前验证权限。
安全审计
安全v5 • 2026/7/23 打开版本化报告
All static findings are false positives caused by Markdown formatting, static Python imports, Azure placeholders, documented environment access, and search terminology. No command execution, embedded secret, exfiltration, prompt injection, or malicious intent was found.
1
已扫描文件
537
分析行数
0
复核项
0
已忽略误报
风险因素
⚙️ 外部命令 (50)
SKILL.md:15-17 SKILL.md:17-21 SKILL.md:21-25 SKILL.md:25-31 SKILL.md:31-40 SKILL.md:40-44 SKILL.md:44-53 SKILL.md:53-59 SKILL.md:59-60 SKILL.md:60-61 SKILL.md:61-65 SKILL.md:65-112 SKILL.md:112-116 SKILL.md:116-132 SKILL.md:132-136 SKILL.md:136-145 SKILL.md:145-149 SKILL.md:149-168 SKILL.md:168-172 SKILL.md:172-187 SKILL.md:187-191 SKILL.md:191-206 SKILL.md:206-210 SKILL.md:210-217 SKILL.md:217-221 SKILL.md:221-232 SKILL.md:232-236 SKILL.md:236-250 SKILL.md:250-254 SKILL.md:254-296 SKILL.md:296-323 SKILL.md:323-327 SKILL.md:327-329 SKILL.md:329-333 SKILL.md:333-338 SKILL.md:338-343 SKILL.md:343-349 SKILL.md:349-352 SKILL.md:352-357 SKILL.md:357-363 SKILL.md:363-364 SKILL.md:364-365 SKILL.md:365-366 SKILL.md:366-370 SKILL.md:370-417 SKILL.md:417-421 SKILL.md:421-434 SKILL.md:434-438 SKILL.md:438-469 SKILL.md:469-478
🌐 网络访问 (2)
最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。
审计者: codex 查看审计历史 →
分享与引用此报告
分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。
复制报告链接
https://skillstore.io/skills/sickn33-azure-search-documents-py/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/sickn33-azure-search-documents-py?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/sickn33-azure-search-documents-py?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/sickn33-azure-search-documents-py/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/sickn33-azure-search-documents-py.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>学术引用 (APA · BibTeX · CFF)
APA 引用
sickn33. (2026). azure-search-documents-py security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/sickn33-azure-search-documents-py/audits/5BibTeX 引用
@techreport{sickn33-sickn33-azure-search-documents-py-2026,
author = {sickn33},
title = {azure-search-documents-py security audit report (audit version 5)},
institution = {Skillstore},
year = {2026},
number = {5},
url = {https://skillstore.io/skills/sickn33-azure-search-documents-py/audits/5},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "azure-search-documents-py security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
- name: "sickn33"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/sickn33-azure-search-documents-py/audits/5"
identifiers:
- type: other
value: "skillstore:sickn33-azure-search-documents-py:audit:5"
description: "Skillstore immutable audit report identifier"
Skillstore 评分
评分依据 证据置信度: 高 55
架构
85
可维护性
87
内容
69
社区
78
规范符合性
你能构建什么
创建搜索索引
在 Python 中定义字段、向量配置文件、语义配置和幂等索引创建。
为 AI 应用添加检索
为检索工作流组合向量查询、关键字搜索、筛选器和语义排序。
维护搜索数据管道
使用上传、合并、删除、批处理、索引器、技能组和错误处理模式。
试试这些提示
启动搜索客户端
使用 Azure Search Documents Python SDK 为我现有的索引创建一个 SearchClient。优先使用 DefaultAzureCredential，并解释我需要哪些环境值。
构建向量索引
为包含 id、title、content 和 embedding 字段的 Azure AI Search 索引起草 Python 代码。包含 HNSW 向量搜索设置，以及有关匹配嵌入维度的说明。
设计混合检索
创建一个 Python 搜索模式，使用 VectorizedQuery、关键字文本、选定字段、筛选器、top 结果和语义排序来运行混合检索。
规划扩充管道
为批量文档引入、索引器设置、技能组扩充、具备重试感知的上传以及生产环境错误处理，设计一个 Azure AI Search Python 工作流。
最佳实践
- 在部署支持的情况下，生产身份验证优先使用 DefaultAzureCredential。
- 在创建或更新索引之前，使向量维度与嵌入模型匹配。
- 对大型文档引入工作负载使用批处理和具备重试感知的客户端。
避免
- 不要在生成的应用程序代码中硬编码真实服务密钥或端点。
- 不要在同一个字段中混用来自不同嵌入模型的向量维度。
- 不要在未调整字段、筛选器、权限和排序设置的情况下部署示例架构。
常见问题
此技能会为我创建 Azure 资源吗？
不会。它为 Azure AI Search 工作流提供 Python SDK 指导。你必须提供服务、权限和配置。
我可以将它与 Claude、Codex 和 Claude Code 一起使用吗？
可以。此技能被组织为适用于 Claude、Codex 和 Claude Code 工作流的指导。
它支持向量搜索吗？
支持。它包含向量字段设置、HNSW 配置、向量查询和混合搜索示例。
它推荐使用 API 密钥吗？
它展示 API 密钥示例，但也将 DefaultAzureCredential 标记为首选生产方法。
它能帮助处理语义排序吗？
可以。它涵盖语义查询类型、语义配置、字幕以及组合式混合检索模式。
生产使用前应验证什么？
验证凭据、索引架构、向量维度、数据访问控制、重试行为、监控和成本影响。