Flutter人工智能处理插件conva_ai_core的使用

Flutter人工智能处理插件conva_ai_core的使用

CONVA.ai from Slang Labs 是世界上第一个作为服务的Copilot平台，允许开发者以最少的努力在他们的应用程序中轻松添加增强的人工智能体验（AUX）。

初始化

ConvaAI.init(id: "<AssistantID>", key: "<APIKey>", version: "<Version>");

调试响应

CONVA AI 使用生成式人工智能来给出你的查询的答案。为了让你理解答案背后的推理，我们还为你提供了人工智能的推理过程。

非流式能力完成调用

try {
  Response completion =
      await ConvaAI.invokeCapability(input: "<input_query>");
      print(completion);
} catch (error) {
  print(error);
}

流式能力完成调用

Stream<Response> completionStream =
ConvaAI.invokeCapabilityStream(
  input: "<input_query>",
);
completionStream.listen(
      (event) {
      print(event);
  },
  onError: (error) {
    print(error);
  },
);

使用能力名称

能力名称提供了一种直接调用特定功能的方法，而无需从能力组中选择它们。对于有针对性和高效的执行，开发人员可以直接使用其唯一名称调用功能。这在事先知道所需功能时非常理想。

非流式能力名称完成调用

try {
  Response completion =
      await ConvaAI.invokeCapabilityWithName(input: "<input_query>", capability: "<your_capability_name>");
      print(completion);
} catch (error) {
  print(error);
}

流式能力名称完成调用

Stream<Response> completionStream =
ConvaAI.invokeCapabilityStream(
  input: "<input_query>", 
  capability: "<your_capability_name>"
);
completionStream.listen(
      (event) {
      print(event);
  },
  onError: (error) {
    print(error);
  },
);

使用能力组

能力组用于控制助手将具有哪些能力。

非流式能力组完成调用

try {
  Response completion =
      await ConvaAI.invokeCapability(input: "<input_query>", capabilityGroup: "<your_capability_group>");
      print(completion);
} catch (error) {
  print(error);
}

流式能力组完成调用

Stream<Response> completionStream =
ConvaAI.invokeCapabilityStream(
  input: "<input_query>",
  capabilityGroup: "<CAPABILITY_GROUP_NAME>"
);
completionStream.listen(
      (event) {
      print(event);
  },
  onError: (error) {
    print(error);
  },
);

完整示例Demo

以下是一个完整的示例代码，展示了如何使用 conva_ai_core 插件：

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:conva_ai_core/conva_ai_core.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _initStatus = 'Initialization Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们通过异步方法进行初始化。
  Future<void> initPlatformState() async {
    String success = "unknown";

    // 如果小部件在异步平台消息飞行时从树中移除，我们需要丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _initStatus = success;
    });

    ConvaAI.init(id: "<AssistantID>", key: "<APIKey>", version: "<Version>");

    // 调用能力API
    try {
      Response completion =
          await ConvaAI.invokeCapability(input: "Hello World");
      setState(() {
        _initStatus = completion.toString();
      });
    } catch (error) {
      setState(() {
        _initStatus = 'Error: ${error.toString()}';
      });
    }

    // 取消注释此行以调用带名称的能力API
    // try {
    //   Response completion =
    //     await ConvaAI.invokeCapabilityWithName(input: "<input_query>", capability: "<your_capability_name>");
    //   setState(() {
    //     _initStatus = completion.toString();
    //   });
    // } catch (error) {
    //   setState(() {
    //     _initStatus = 'Error: ${error.toString()}';
    //   });
    // }

    // 取消注释此行以调用带流式的能力API
    // ConvaAI.invokeCapabilityStream(
    //   input: "<input_query>",
    // ).listen((response) {
    //   setState(() {
    //       _initStatus = response.toString();
    //   });
    // }, onError: (error) {
    //     setState(() {
    //       _initStatus = 'Error: ${error.toString()}';
    //     });
    // });

    // 取消注释此行以调用带名称流式的能力API
    // ConvaAI.invokeCapabilityWithNameStream(
    //   input: "<input_query>",
    //   capability: "<your_capability_name>"
    // ).listen((response) {
    //     setState(() {
    //         _initStatus = response.toString();
    //     });
    // }, onError: (error) {
    //     setState(() {
    //       _initStatus = 'Error: ${error.toString()}';
    //     });
    // });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('$_initStatus\n'),
        ),
      ),
    );
  }
}