我们采用单条元数据对应一个向量的策略，而非分别对name/description/alias三个字段分别生成三个向量。具体转换流程如下：

1. 字段记录示例：

ColumnInfo(
id="fact_order.order_amount"。name="order_amount",description="订单金额。",alias=,...
)
pre>

转换为待向量化输入：
business_id:
fact_order.order_amountembedding_text:
字段名称的观点是。order_amount
至于字段描述，订单金额。字段别名这方面，销售额、订单金额、收入payload:
字段ID、表ID、类型、角色、别名等原始信息

TEI生成向量后写入Qdrant：
{
说到""id"，"根据业务ID稳定生成的UUID v5",""vector":。
""payload": {
"metadata_type": "column_info","id": "fact_order.order_amount","name": "order_amount","description": "订单金额。","alias":,"embedding_text": "字段名称：..."。...
}
pre>



Point ID使用UUID v5由业务ID派生而来确保同步可重复执行；

payload包含完整业务信息供应用识别具体字段或指标。

. 配置管理与依赖关系 

. 配置示例 
qdrant这方面，host: localhost port: embedding_size: column_collection: column_info_collection metric_collection: metric_info_collection timeout:
embedding:
至于host。localhost port: model: BAAI/bge-large-zh-v1. # CPU TEI最大并行处理条数 batch_size: timeout:


服务名称 
端口号范围 
主要功能描述 

TEIlocalhost:
文本转换为特征向量

Qdrantlocalhost:
保存并检索相似度最接近的向量

说到依赖安装，bash
uv add httpx qdrant-client==.




httpx库用于调用TEI服务；qdrant-client是官方提供的Python客户端SDK；两者版本需与当前环境兼容。



. EmbeddingClient设计思路与实现细节 


EmbeddingClient专注于调用本地TEI服务完成文本到向量的转换工作：
python hljs language-python""lang=pytho"
class EmbeddingClient:
def init:
self.client httpx.AsyncClient(
baseurl baseurl.rstrip。timeout timeout,trustenv False,)
async def embed -> list]:
if not texts return
response await self.client.post(
"/embed",json { inputs texts,truncate True }
)
response.raisefor_status
vectors response.json
if not isinstance or len!= len:
raise ValueError
return vectors"""""




. LangChain适配层实现：
python hljs language-python""lang=pytho"
async def aembed_documents(
self texts list
) -> list]:
return await self.embed

async def aembed_query -> list:
return )


这两个方法共享底层embed接口但提供不同语义：



"aembeddocuments适用于批处理多个文档；老实说，aembedquery则针对单条查询调整。"



. 使用官方AsyncQdrantClient进行轻度封装以保持一致性：
python hljs language-python""lang=pytho"
from qdrant_client import AsyncQdrancClie"

class QdanrClicl:
def init(
self baseurl str timeout float =
super.init(
url baseurl.rstrip timeout int
"""
""""



. 调用方式统一规范示例：
python hljs language-python""lang=pytho"

qdranc_clic Qdraclie
"""
""""