Flutter未知功能探索插件tavily_dart的使用

发布于 1周前 作者 sinazl 来自 Flutter

Flutter未知功能探索插件tavily_dart的使用

Tavily Dart Client

Dart客户端用于Tavily API(一种针对LLM和RAG优化的搜索引擎)。

功能

  • 完全类型安全、文档化并经过测试
  • 支持所有平台
  • 支持自定义基础URL、头信息和查询参数(例如HTTP代理)
  • 支持自定义HTTP客户端(例如SOCKS5代理或高级用例)

支持的端点:

  • 搜索

目录

使用

参考文档获取更多关于API的信息。

认证

Tavily API使用API密钥进行认证。访问Tavily控制台以获取您将在请求中使用的API密钥。

请记住,您的API密钥是秘密的! 不要与他人分享或在任何客户端代码(浏览器、应用程序)中暴露它。生产请求必须通过您自己的后端服务器路由,在那里您的API密钥可以安全地从环境变量或密钥管理服务加载。

final apiKey = Platform.environment['TAVILY_API_KEY'];
final client = TavilyClient();
搜索

基于查询搜索数据。

基本搜索:

// 创建搜索请求
final res = await client.search(
  request: SearchRequest(
    apiKey: apiKey, // API密钥
    query: 'Should I invest in Apple right now?', // 查询字符串
  ),
);
print(res); // 打印结果

高级搜索:

// 创建高级搜索请求
final res = await client.search(
  request: SearchRequest(
    apiKey: apiKey,
    query: 'Should I invest in Apple right now?',
    searchDepth: SearchRequestSearchDepth.advanced, // 设置为高级搜索
  ),
);
print(res); // 打印结果

参见API文档了解所有支持的搜索参数。

高级使用

自定义HTTP客户端

您可以始终提供自己的http.Client实现以进一步定制:

final client = TavilyClient(
  client: MyHttpClient(), // 自定义HTTP客户端
);
使用代理
HTTP代理

您可以通过覆盖baseUrl并提供所需的headers来使用自己的HTTP代理:

final client = TavilyClient(
  baseUrl: 'https://my-proxy.com', // 自定义基础URL
  headers: {
      'x-my-proxy-header': 'value', // 自定义头信息
  },
);

如果需要进一步定制,您可以始终提供自己的http.Client

SOCKS5代理

要使用SOCKS5代理,可以使用socks5_proxy包:

final baseHttpClient = HttpClient();
SocksTCPClient.assignToHttpClient(baseHttpClient, [
  ProxySettings(InternetAddress.loopbackIPv4, 1080), // 设置SOCKS5代理
]);
final httpClient = IOClient(baseClient);

final client = TavilyClient(
  client: httpClient, // 使用自定义HTTP客户端
);

致谢

此客户端的生成得益于openapi_spec包。

许可证

Tavily Dart Client根据MIT License许可。

示例代码

以下是一个完整的示例demo,展示如何使用tavily_dart插件进行基本和高级搜索:

// ignore_for_file: avoid_print
import 'dart:io';

import 'package:tavily_dart/tavily_dart.dart';

void main() async {
  // 获取API密钥
  final apiKey = Platform.environment['TAVILY_API_KEY']!;
  
  // 初始化Tavily客户端
  final client = TavilyClient();

  // 基本搜索
  final res1 = await client.search(
    request: SearchRequest(
      apiKey: apiKey, // API密钥
      query: 'Should I invest in Apple right now?', // 查询字符串
    ),
  );
  print(res1); // 打印基本搜索结果

  // 高级搜索
  final res2 = await client.search(
    request: SearchRequest(
      apiKey: apiKey, // API密钥
      query: 'Should I invest in Apple right now?', // 查询字符串
      searchDepth: SearchRequestSearchDepth.advanced, // 设置为高级搜索
    ),
  );
  print(res2); // 打印高级搜索结果
}

更多关于Flutter未知功能探索插件tavily_dart的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter未知功能探索插件tavily_dart的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,以下是一个关于如何在Flutter项目中使用tavily_dart插件的示例代码案例。tavily_dart插件可能是一个用于探索Flutter中未知功能或特定API的库(请注意,由于tavily_dart并非一个广泛知名的标准库,以下代码是基于假设该插件提供了一些探索性功能而编写的)。

首先,确保在你的pubspec.yaml文件中添加tavily_dart依赖:

dependencies:
  flutter:
    sdk: flutter
  tavily_dart: ^x.y.z  # 替换为实际的版本号

然后,运行flutter pub get来安装依赖。

接下来,在你的Flutter项目中,你可以使用tavily_dart插件来探索一些未知功能。以下是一个简单的示例,展示如何初始化插件并使用其可能提供的功能(注意,具体API和方法需要参考tavily_dart的官方文档,以下代码为假设性示例):

import 'package:flutter/material.dart';
import 'package:tavily_dart/tavily_dart.dart';  // 假设这是插件的导入路径

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Tavily Dart Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String result = "";

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Tavily Dart Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'Result:',
              style: TextStyle(fontSize: 20),
            ),
            Text(
              result,
              style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () => exploreUnknownFunction(),
              child: Text('Explore Unknown Function'),
            ),
          ],
        ),
      ),
    );
  }

  void exploreUnknownFunction() async {
    // 假设tavily_dart有一个名为explore的函数,它返回一个String结果
    try {
      String resultFromPlugin = await TavilyDart.explore();  // 替换为实际的方法调用
      setState(() {
        result = resultFromPlugin;
      });
    } catch (e) {
      setState(() {
        result = "Error: ${e.message}";
      });
    }
  }
}

在这个示例中,我们创建了一个简单的Flutter应用,其中包含一个按钮,当用户点击该按钮时,会调用TavilyDart.explore()方法(这是一个假设的方法名,你需要根据tavily_dart的实际API进行替换)。该方法返回一个字符串结果,并在界面上显示。

请注意,由于tavily_dart并非一个广泛认知的库,因此上述代码中的方法名TavilyDart.explore()和导入路径package:tavily_dart/tavily_dart.dart都是基于假设的。你需要查阅tavily_dart的官方文档或源代码,以了解如何正确导入和使用该插件。

如果你找不到tavily_dart的官方文档,可以尝试在GitHub上搜索该库的仓库,通常仓库的README文件会包含详细的使用说明和API文档。

回到顶部