microsoft-foundry-local

Microsoft Foundry Local 技能

此技能提供有关 Microsoft Foundry Local 的专业指导，涵盖最佳实践、决策、配置、集成和编码模式。它结合了本地快速参考内容与远程文档获取功能。

如何使用此技能

IMPORTANT for Agent：使用下面的类别索引查找相关章节。对于带有行号范围的类别（例如，L35-L120），使用 read_file 读取指定行。对于带有文件链接的类别（例如，[security.md](security.md)），使用 read_file 读取链接的参考文件

IMPORTANT for Agent：如果 metadata.generated_at 的时间距今超过 3 个月，请建议用户从仓库拉取最新版本。如果 mcp_microsoftdocs 工具不可用，请建议用户安装它：安装指南

此技能需要网络访问权限才能获取文档内容：

• 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并将查询字符串设为 from=learn-agent-skill。返回 Markdown。
• 备用：使用 fetch_webpage，并将查询字符串设为 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别	行号	说明
最佳实践	L32-L36	排查 Foundry Local CLI 问题、应用推荐的工作流，以及解决常见的设置、身份验证、生成和部署问题。
决策	L37-L42	关于如何在旧版与当前 Foundry Local SDK 之间进行选择的指导，以及将现有应用迁移到当前 SDK 的分步说明。
配置	L43-L49	配置和运行 Foundry Local：使用 Olive 编译 Hugging Face 模型、安装/使用 CLI，以及所有 CLI 命令和选项的参考。
集成和编码模式	L50-L61	在代码中使用 Foundry Local API/SDK 实现文本嵌入、聊天补全、音频转录、工具调用、LangChain 应用，以及 OpenAI 风格或 REST 集成

最佳实践

主题	URL
应用最佳实践并排查 Foundry Local CLI 问题	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-best-practice

决策

主题	URL
在旧版与当前 Foundry Local SDK 之间进行选择	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-legacy
将应用迁移到当前 Foundry Local SDK	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-migration

配置

主题	URL
使用 Olive 为 Foundry Local 编译 Hugging Face 模型	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models
运行和配置 Foundry Local CLI	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-foundry-local-cli
Foundry Local CLI 命令和选项参考	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-cli

集成与编码模式

主题	URL
使用 Foundry Local SDK 生成文本嵌入	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-generate-embeddings
将 Foundry Local 与 OpenAI 风格的推理 SDK 集成	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks
使用 Foundry Local 进行实时麦克风转录	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-live-transcribe-audio
使用 Foundry Local 转录 API 转录音频	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-transcribe-audio
使用 Foundry Local 构建 LangChain 翻译应用	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-langchain-with-foundry-local
使用 Foundry Local 原生聊天补全 API	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions
使用 Foundry Local 模型实现工具调用	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local
用于本地推理的 Foundry Local REST API 参考	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-rest
在应用程序中使用 Foundry Local SDK API	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-current