ui设计方向网站建设目标,做网站去哪里投放广告,孔为民医生个人网站,河南网站建设yipinpai作者#xff1a;来自 Elastic Jeffrey Rengifo 了解如何将 Elasticsearch 与 Microsoft 365 Copilot Chat 和 Microsoft Teams 中的 Copilot 搭配使用。 Elasticsearch 原生集成了业界领先的生成式 AI 工具和提供商。查看我们的网络研讨会#xff0c;了解超越 RAG 基础的内容…作者来自 Elastic Jeffrey Rengifo 了解如何将 Elasticsearch 与 Microsoft 365 Copilot Chat 和 Microsoft Teams 中的 Copilot 搭配使用。 Elasticsearch 原生集成了业界领先的生成式 AI 工具和提供商。查看我们的网络研讨会了解超越 RAG 基础的内容或构建可投入生产的应用程序 Elastic Vector Database。
为了为你的使用场景构建最佳的搜索解决方案现在可以开始免费云试用或者在本地机器上尝试 Elastic。 本文将指导你如何将 Elasticsearch 与 Microsoft Copilot 集成。我们将构建一个能够从你的 Elasticsearch 文档中检索并使用数据的自定义代理。 什么是 Microsoft Copilot
Microsoft Copilot 是一个 AI 助手帮助你在 Microsoft 生态系统产品中完成各类任务提供类似于 ChatGPT 的功能满足各种生产力需求。 通过使用 Microsoft Copilot Studio 和图形界面你可以构建自定义 agent并为它们配置 actions。这些 actions 会连接到你的 API以获取数据并响应用户查询。
action 是 agent 可用来帮助你完成任务的工具。这些 actions 可以连接到平台内置的连接器或连接到 API。OpenAPI JSON 规范为描述你的 API 提供了一种标准格式使 Copilot 能理解它的功能、可用的端点以及如何正确构造查询包括自动填充参数。
我们将构建一个 agent用于提供存储在 Elasticsearch 中的发票信息通过 API 连接。这个 agent 将运行在 Microsoft Teams 上作为个人助手使用。
本教程将引导你完成以下步骤 构建 API 设置 Elasticsearch 数据 配置 Copilot 和 agent 使用 agent
本文中引用的所有代码和文件都可以在这个 GitHub 仓库中找到。 构建 API
我们将创建一个查询 Elasticsearch 的简单 API。我们会在 Jupyter notebook 中使用 FastAPI 来构建它。
%pip install fastapi pyngrok uvicorn nest-asyncio elasticsearch9 -q
在导入这些工具之前让我们先回顾一下已安装的工具
fastapi, uvicorn生成一个用于访问 Elasticsearch 的 HTTP 服务器。pyngrok为本地服务器创建一个安全的公共 IP 地址隧道使 Copilot agent 能通过互联网访问它。这个和花生壳有点类似。elasticsearchElasticsearch 的 Python 客户端。nest-asyncio在 Notebook 环境中创建服务器所需。
import os
from datetime import datetimeimport nest_asyncio
import uvicornfrom fastapi import FastAPI, Query
from pyngrok import conf, ngrokfrom elasticsearch.helpers import bulk
from elasticsearch import Elasticsearch
要在 Copilot agent 中使用这个 API我们需要让它可以通过互联网访问。因此我们将使用 ngrok 创建一个隧道把 API 连接到互联网。在这里创建一个 ngrok 账户并获取一个 auth token。
让我们来配置环境变量
os.environ[ELASTICSEARCH_ENDPOINT] (Elasticsearch_endpoint
)
os.environ[ELASTICSEARCH_API_KEY] (Elasticsearch_api_key
)
os.environ[NGROK_AUTH_TOKEN] ngrok-token
INDEX_NAME invoices
现在实例化 Elasticsearch 客户端
_client Elasticsearch(os.environ[ELASTICSEARCH_ENDPOINT],api_keyos.environ[ELASTICSEARCH_API_KEY],
)
让我们启动服务器并创建以下端点
/search/semantic
根据用户的查询执行语义搜索。
/search/by-date
根据日期范围执行搜索。
在这两种情况下Elasticsearch 都会返回每个查询的一组文档。
app FastAPI()app.get(/search/semantic)
async def search_semantic(query: str Query(None)):# ... full code in the GitHub repository ...app.get(/search/by-date)
async def search_by_date(from_date: str Query(None), to_date: str Query(None)):# ... full code in the GitHub repository ...
让我们配置隧道并运行服务器。
conf.get_default().auth_token os.environ[NGROK_AUTH_TOKEN]
ngrok_tunnel ngrok.connect(8000)print(Public URL:, ngrok_tunnel.public_url)nest_asyncio.apply()
uvicorn.run(app, port8000)
你获得的 Public URL 将提供给我们的 Microsoft Copilot agent。
Public URL: https://81c1-181-237-140-155.ngrok-free.appINFO: Started server process [77882]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRLC to quit) 设置 Elasticsearch 数据 映射
我们将索引一系列发票其中包含所提供服务的描述、日期、参考 URL、总金额和描述。
我们还会将需要用于语义搜索的属性复制到一个名为 semantic_field 的字段类型中。
_client.indices.create(indexINDEX_NAME,body{mappings: {properties: {id: {type: keyword},file_url: {type: keyword},issue_date: {type: date},description: {type: text, copy_to: semantic_field},services: {type: object,properties: {name: {type: text,copy_to: semantic_field,},price: {type: float},},},total_amount: {type: float,},semantic_field: {type: semantic_text},}}},) 索引数据
我们将上传一组不同的发票。数据集可以在这里找到。
让我们创建一个函数遍历发票数组并使用 bulk API 将其索引到 Elasticsearch 中。
def build_data():for doc in invoices:yield {_index: INDEX_NAME, _source: doc}try:success, errors bulk(_client, build_data())print(f{success} documents indexed successfully)if errors:print(Errors during indexing:, errors)except Exception as e:print(fError: {str(e)}, please wait some seconds and try again.) Copilot 和代理配置
使用 Copilot chat 需要一个 Office 365 账户。如果你没有可以在这里创建试用账户。 创建代理和操作
创建账户后访问主 Copilot Studio 网站按照以下说明操作 按照微软的步骤创建一个代理create an agent。 从 REST API 添加操作。 一个 action 是一个 API 端点。这个例子里你需要添加两个一个用于语义文本查询另一个用于基于日期的查询。 为此你需要先生成你刚创建的 API 的 OpenAPI JSON 参考。你可以在专门为本文准备的 GitHub 仓库里找到 OpenAPI 规范文件。在 OpenAPI 配置中把已有的 host 值替换成 ngrok 生成的 URL。注意去掉 https:// 前缀只保留主机名和端口。 点击 Settings 并启用 Generative AI以便使用 GenAI 处理对话。根据 Copilot 在对话中检测到的内容选择 Actions、Knowledge 和 Topics。 点击 Overview然后向下滚动你会找到 Knowledge 部分。关闭选项 Allow the AI to use its own general knowledge。这样可以防止代理使用其训练中的通用信息进行回答因为我们希望它们专注于我们的 Elasticsearch 文档。 如果你使用的是 ngrok 免费层必须设置请求头 ngrok-skip-browser-warning其值可以是任意内容。这样可以绕过 ngrok 要求的浏览器验证步骤因为免费通道可能会被滥用。为此前往 “Actions [Action] Inputs Ngrok Skip Browser Warning”点击 “How will the agent fill this input?”选择 “Set as value”。在 Value 中填写任意值后点击 “Save”这样你就可以通过 ngrok 通道使用这些端点了。 让代理在 Copilot 中可见
要在 Microsoft 365 或 Microsoft Teams 中使用该代理你必须按照以下步骤操作 在 Copilot Studio 中进入 Channels然后点击 Teams Microsoft 365 取消选择 “Make agent available in Microsoft 365 Copilot Chat” 选项。这个选项只适用于你想在 Microsoft 365 Copilot 中使用代理的情况而我们是要在 Microsoft Teams 中使用它。 现在点击 “Add channel”。 将代理添加到频道后点击 “See agent in Teams”然后直接将其添加到 Teams 中。 添加完成后你就可以在 Copilot 中通过输入 并从选项中选择该代理来开始使用它。 使用代理
首次使用 actions 时Copilot 会提示权限问题并在需要你授权每个 action 时显示一个框点击 Connect 即可授予权限。每个 action 只需授权一次。 你现在已经可以开始使用代理了。
要测试语义搜索我们可以向代理询问有关餐饮费用的发票
Which invoices have billed items related to food comsumption? 让我们来看一下回答结果
得益于语义搜索功能Copilot 能够找到那些虽然没有包含 “food” 一词但包含像 “dinner” 和 “lunch” 这类词的发票。 在 API 日志中我们可以验证被调用的端点和 Copilot 生成的查询。在这个例子里查询是 “food consumption”。 在这个文件中找到 JSON 格式的查询内容以及 Elasticsearch 针对前一个查询返回的原始命中结果。
现在让我们通过查询特定时间范围内开具的发票来测试日期范围搜索
invoices between 20 of April and 22 of April 以下是结果
Invoice ID: INV-0011 Description: Business lunch with clientServices: Lunch at La Terraza Bistro - $85.00Total Amount: $85.00Issue Date: 2025-04-20View Invoice Invoice ID: INV-0012 Description: Hotel accommodation during client visitServices: 3-night stay at Hotel Central - $450.00Total Amount: $450.00Issue Date: 2025-04-21View Invoice Invoice ID: INV-0013 Description: Team-building activityServices: Escape room experience for team - $200.00Total Amount: $200.00Issue Date: 2025-04-22View Invoice
通过查看 API 请求我们可以确认 Copilot 正确地解析了数据和所选的端点 范围查询如下所示你还可以看到 Elasticsearch 返回的数据。 结论
本文中我们成功地将 Elasticsearch 与 Microsoft Copilot 集成创建了一个能够访问我们索引的个人助理。
通过使用带有清晰描述的 API OpenAI 规范代理能够有效地选择并调用合适的端点。
这种架构类似于 Model Context ProtocolMCP在未来的文章中我们将探讨 Microsoft Copilot 与 MCP 以及 Elasticsearch MCP 服务器的新集成。 原文Improving Copilot capabilities using Elasticsearch - Elasticsearch Labs 文章转载自： http://www.morning.gnkdp.cn.gov.cn.gnkdp.cn http://www.morning.tpdg.cn.gov.cn.tpdg.cn http://www.morning.c7497.cn.gov.cn.c7497.cn http://www.morning.tqpds.cn.gov.cn.tqpds.cn http://www.morning.rsxw.cn.gov.cn.rsxw.cn http://www.morning.fycjx.cn.gov.cn.fycjx.cn http://www.morning.tsnq.cn.gov.cn.tsnq.cn http://www.morning.krrjb.cn.gov.cn.krrjb.cn http://www.morning.skbhl.cn.gov.cn.skbhl.cn http://www.morning.gwyml.cn.gov.cn.gwyml.cn http://www.morning.xdnhw.cn.gov.cn.xdnhw.cn http://www.morning.rzcfg.cn.gov.cn.rzcfg.cn http://www.morning.qxmnf.cn.gov.cn.qxmnf.cn http://www.morning.knczz.cn.gov.cn.knczz.cn http://www.morning.qlpq.cn.gov.cn.qlpq.cn http://www.morning.wfykn.cn.gov.cn.wfykn.cn http://www.morning.smdiaosu.com.gov.cn.smdiaosu.com http://www.morning.cmqrg.cn.gov.cn.cmqrg.cn http://www.morning.bmqls.cn.gov.cn.bmqls.cn http://www.morning.tgpgx.cn.gov.cn.tgpgx.cn http://www.morning.jwgnn.cn.gov.cn.jwgnn.cn http://www.morning.fbbmg.cn.gov.cn.fbbmg.cn http://www.morning.ljqd.cn.gov.cn.ljqd.cn http://www.morning.gqfjb.cn.gov.cn.gqfjb.cn http://www.morning.zkbxx.cn.gov.cn.zkbxx.cn http://www.morning.pxlsh.cn.gov.cn.pxlsh.cn http://www.morning.gqfbl.cn.gov.cn.gqfbl.cn http://www.morning.yrsg.cn.gov.cn.yrsg.cn http://www.morning.qcbhb.cn.gov.cn.qcbhb.cn http://www.morning.khxwp.cn.gov.cn.khxwp.cn http://www.morning.nkqrq.cn.gov.cn.nkqrq.cn http://www.morning.lrflh.cn.gov.cn.lrflh.cn http://www.morning.xgjhy.cn.gov.cn.xgjhy.cn http://www.morning.qqklk.cn.gov.cn.qqklk.cn http://www.morning.rbsmm.cn.gov.cn.rbsmm.cn http://www.morning.hmqjj.cn.gov.cn.hmqjj.cn http://www.morning.gjtdp.cn.gov.cn.gjtdp.cn http://www.morning.jgykx.cn.gov.cn.jgykx.cn http://www.morning.qtbnm.cn.gov.cn.qtbnm.cn http://www.morning.qjtbt.cn.gov.cn.qjtbt.cn http://www.morning.qxxj.cn.gov.cn.qxxj.cn http://www.morning.rnyhx.cn.gov.cn.rnyhx.cn http://www.morning.lkhfm.cn.gov.cn.lkhfm.cn http://www.morning.irqlul.cn.gov.cn.irqlul.cn http://www.morning.zwpzy.cn.gov.cn.zwpzy.cn http://www.morning.ycgrl.cn.gov.cn.ycgrl.cn http://www.morning.rybr.cn.gov.cn.rybr.cn http://www.morning.hmdn.cn.gov.cn.hmdn.cn http://www.morning.njntp.cn.gov.cn.njntp.cn http://www.morning.lwnwl.cn.gov.cn.lwnwl.cn http://www.morning.wcghr.cn.gov.cn.wcghr.cn http://www.morning.fxzw.cn.gov.cn.fxzw.cn http://www.morning.jcxyq.cn.gov.cn.jcxyq.cn http://www.morning.addai.cn.gov.cn.addai.cn http://www.morning.qnwyf.cn.gov.cn.qnwyf.cn http://www.morning.mrkbz.cn.gov.cn.mrkbz.cn http://www.morning.kmkpm.cn.gov.cn.kmkpm.cn http://www.morning.bpmtj.cn.gov.cn.bpmtj.cn http://www.morning.rxtxf.cn.gov.cn.rxtxf.cn http://www.morning.tlzbt.cn.gov.cn.tlzbt.cn http://www.morning.hpdpp.cn.gov.cn.hpdpp.cn http://www.morning.xknsn.cn.gov.cn.xknsn.cn http://www.morning.prfrb.cn.gov.cn.prfrb.cn http://www.morning.wjrtg.cn.gov.cn.wjrtg.cn http://www.morning.lmmkf.cn.gov.cn.lmmkf.cn http://www.morning.fzlk.cn.gov.cn.fzlk.cn http://www.morning.sqgqh.cn.gov.cn.sqgqh.cn http://www.morning.daidudu.com.gov.cn.daidudu.com http://www.morning.pxlql.cn.gov.cn.pxlql.cn http://www.morning.kdldx.cn.gov.cn.kdldx.cn http://www.morning.lmzpk.cn.gov.cn.lmzpk.cn http://www.morning.ljhnn.cn.gov.cn.ljhnn.cn http://www.morning.qfdmh.cn.gov.cn.qfdmh.cn http://www.morning.yhljc.cn.gov.cn.yhljc.cn http://www.morning.qkkmd.cn.gov.cn.qkkmd.cn http://www.morning.lywys.cn.gov.cn.lywys.cn http://www.morning.xfxlr.cn.gov.cn.xfxlr.cn http://www.morning.jzklb.cn.gov.cn.jzklb.cn http://www.morning.ygkk.cn.gov.cn.ygkk.cn http://www.morning.rmxwm.cn.gov.cn.rmxwm.cn
