Flutter未知功能插件pinecone的介绍（由于介绍为undefined，基于名称推测） Flutter数据连接或通信插件pinecone的使用

Flutter未知功能插件pinecone的介绍（由于介绍为undefined，基于名称推测）

Flutter数据连接或通信插件pinecone的使用

pinecone 是一个用于与托管的 Pinecone 向量数据库实例进行交互的 Dart 客户端。该插件允许你执行各种操作，如创建和管理索引、集合以及向量操作。

索引操作

索引操作包括列出索引、创建索引、描述索引、删除索引和配置索引。

/// 列出索引
List<String> indexes = await client.listIndexes(
  environment: environment,
);

/// 创建索引
await client.createIndex(
  environment: environment,
  request: CreateIndexRequest(
    name: indexName,
    dimension: dimension,
    metric: SearchMetric.cosine,
    pods: 1,
    replicas: 1,
    podType: PodType.p1x1,
  ),
);

/// 描述索引
Index index = await client.describeIndex(
  environment: environment,
  indexName: indexName,
);

/// 删除索引
await client.deleteIndex(
  environment: environment,
  indexName: indexName,
);

/// 配置索引
await client.configureIndex(
  environment: environment,
  indexName: indexName,
  request: ConfigureIndexRequest(
    replicas: 2,
    podType: PodType.p2x2,
  )
);

集合操作

集合操作包括列出集合、创建集合、描述集合和删除集合。

/// 列出集合
List<String> collections = await client.listCollections(
  environment: environment,
);

/// 创建集合
await client.createCollection(
  environment: environment,
  request: CreateCollectionRequest(
    name: collectionName,
    source: indexName,
  ),
);

/// 描述集合
Collection collection = await client.describeCollection(
  environment: environment,
  collectionName: collectionName,
);

/// 删除集合
await client.deleteCollection(
  environment: environment,
  collectionName: collectionName,
);

向量操作

向量操作包括查询、删除、获取、更新和插入向量。

/// 查询向量
QueryResponse queryResponse = await client.queryVectors(
  indexName: index.name,
  projectId: index.projectId,
  environment: index.environment,
  request: QueryRequest(
    vector: queryVector,
  ),
);

/// 删除向量
await client.deleteVectors(
  indexName: index.name,
  projectId: index.projectId,
  environment: index.environment,
  request: DeleteRequest(
    ids: ['vector-0', 'vector-1', 'vector-2'],
  ),
);

/// 获取向量
FetchResponse fetchResponse = await client.fetchVectors(
  indexName: index.name,
  projectId: index.projectId,
  environment: index.environment,
  ids: ['vector-0', 'vector-1', 'vector-2'],
);

/// 更新向量
await client.updateVector(
  indexName: index.name,
  projectId: index.projectId,
  environment: index.environment,
  request: UpdateRequest(
    id: 'vector-5',
    namespace: namespaceName,
    values: List.generate(dimension, (k) => 999.9),
    setMetadata: {'test-meta': 'new-meta-value'},
  ),
);

/// 插入向量
UpsertResponse upsertResponse = await client.upsertVectors(
  indexName: index.name,
  projectId: index.projectId,
  environment: index.environment,
  request: UpsertRequest(
    namespace: namespaceName,
    vectors: [
      for (var i = 0; i < 10; i++)
        Vector(
          id: 'vector-$i',
          values: List.generate(dimension, (k) => (k + i).toDouble()),
          metadata: {'test-meta': 'test-value-$i'},
        ),
    ],
  ),
);

完整示例

以下是一个完整的示例代码，展示了如何使用 pinecone 插件来执行一些基本的操作。

// ignore_for_file: unused_local_variable, avoid_print
import 'dart:io';
import 'package:pinecone/pinecone.dart';

// 创建一个客户端实例
final client = PineconeClient(
  apiKey: Platform.environment['PINECONE_API_KEY'] ?? '',
);

void main() async {
  final environment = 'us-west1-gcp-free';

  /// 列出索引
  final indexes = await client.listIndexes(
    environment: environment,
  );
  print('Indexes: $indexes');

  if (indexes.isEmpty) {
    return;
  }

  /// 描述第一个索引
  if (indexes.isNotEmpty) {
    final index = await client.describeIndex(
      environment: environment,
      indexName: indexes.first,
    );
    print('Index Description: $index');
  }

  /// 列出集合
  final collections = await client.listCollections(
    environment: environment,
  );
  print('Collections: $collections');

  /// 描述第一个集合
  if (collections.isNotEmpty) {
    final collection = await client.describeCollection(
      environment: environment,
      collectionName: collections.first,
    );
    print('Collection Description: $collection');
  }

  // 关闭会话
  client.endSession();
}