NodeJS中Pinecone v1.0.0 Upsert请求报参数类型错误求助

错误信息 #

Error: PineconeArgumentError: The argument to upsert had type errors: argument must be array.

排查与解决步骤 #

1. 检查vector变量的格式 #

报错核心是参数类型不符合要求，最可能的原因是values字段对应的vector不是数值数组。Pinecone要求values必须是由数字组成的数组（如[0.1, 0.2, 0.3]）。

• 先打印vector的类型和内容，确认是否符合要求：

  console.log('vector类型:', typeof vector, 'vector值:', vector);
  

• 如果vector是字符串、对象或其他非数组类型，需要转换为数值数组。比如字符串格式的数组可通过JSON.parse()解析，其他格式则根据生成逻辑调整。

2. 验证upsert参数格式 #

Pinecone v1.x的upsert参数格式无误，但需注意细节：

• vectors数组内的每个元素必须包含id（字符串类型）和values（数值数组），metadata为可选字段。
• 检查namespace变量：如果process.env.PINECONE_NAME_SPACE是undefined或非字符串，可能触发参数校验失败。可添加兜底值避免异常：

  namespace: process.env.PINECONE_NAME_SPACE || ''
  

3. 用测试数组快速验证 #

替换vector为测试用的数值数组，排查是否为原变量的问题：

const upsertResponse = await index.upsert({
  vectors: [
    {
      id: "vec1",
      values: [0.1, 0.2, 0.3, 0.4], // 测试数值数组
      metadata: {
        title: "Hello ",
        body: "Welcome to my world",
      },
    }
  ],
  namespace: process.env.PINECONE_NAME_SPACE || "",
});

如果这段代码执行成功，说明问题出在你原本的vector变量上，需修正其格式。

4. 确认客户端初始化正确性 #

确保Pinecone客户端初始化符合v1.x版本要求：

import { Pinecone } from '@pinecone-database/pinecone';

const pinecone = new Pinecone({
  apiKey: process.env.PINECONE_API_KEY,
});

初始化错误可能导致后续方法的参数校验异常。

内容的提问来源于stack exchange，提问作者Aamir Nakhwa