wit-go: Golang实现的Wit.ai HTTP API客户端

wit-go是一个用于与Wit.ai自然语言处理平台交互的Golang客户端库。下面我将介绍如何使用这个库来实现Wit.ai的各种功能。

安装

首先安装wit-go库：

go get github.com/wit-ai/wit-go

基本用法

1. 初始化客户端

package main

import (
	"fmt"
	"log"
	"github.com/wit-ai/wit-go"
)

func main() {
	// 使用你的Wit.ai服务器访问令牌初始化客户端
	client := witai.NewClient("YOUR_SERVER_ACCESS_TOKEN")
	
	// 可选: 设置自定义HTTP客户端或超时
	// client.HTTPClient = &http.Client{Timeout: 10 * time.Second}
}

2. 发送文本消息并获取意图

func getIntent(client *witai.Client, text string) {
	// 发送消息到Wit.ai
	msg, err := client.Parse(&witai.MessageRequest{
		Query: text,
	})
	if err != nil {
		log.Fatalf("Failed to parse message: %v", err)
	}

	// 打印结果
	fmt.Printf("Text: %s\n", msg.Text)
	fmt.Printf("Intent: %s (confidence: %.2f)\n", 
		msg.Intents[0].Name, 
		msg.Intents[0].Confidence)
	
	// 打印所有实体
	for name, entities := range msg.Entities {
		for _, entity := range entities {
			fmt.Printf("Entity: %s - %v (confidence: %.2f)\n", 
				name, entity.Value, entity.Confidence)
		}
	}
}

3. 语音识别

func speechToText(client *witai.Client, audioFile string) {
	// 打开音频文件
	file, err := os.Open(audioFile)
	if err != nil {
		log.Fatalf("Failed to open audio file: %v", err)
	}
	defer file.Close()

	// 发送语音到Wit.ai进行识别
	msg, err := client.Speech(&witai.MessageRequest{
		Speech: &witai.Speech{
			File:        file,
			ContentType: "audio/wav", // 根据实际音频格式调整
		},
	})
	if err != nil {
		log.Fatalf("Failed to process speech: %v", err)
	}

	fmt.Printf("Recognized text: %s\n", msg.Text)
}

高级功能

1. 管理应用

// 获取应用信息
func getAppInfo(client *witai.Client) {
	app, err := client.GetApp()
	if err != nil {
		log.Fatalf("Failed to get app info: %v", err)
	}
	
	fmt.Printf("App Name: %s\n", app.Name)
	fmt.Printf("App Language: %s\n", app.Lang)
	fmt.Printf("App Private: %v\n", app.Private)
}

// 更新应用信息
func updateApp(client *witai.Client) {
	err := client.UpdateApp(&witai.App{
		Name:    "My Updated App",
		Private: true,
	})
	if err != nil {
		log.Fatalf("Failed to update app: %v", err)
	}
}

2. 管理意图

// 获取所有意图
func listIntents(client *witai.Client) {
	intents, err := client.GetIntents()
	if err != nil {
		log.Fatalf("Failed to get intents: %v", err)
	}
	
	for _, intent := range intents {
		fmt.Printf("Intent: %s\n", intent.Name)
	}
}

// 创建新意图
func createIntent(client *witai.Client, name string) {
	err := client.CreateIntent(name)
	if err != nil {
		log.Fatalf("Failed to create intent: %v", err)
	}
}

3. 管理实体

// 获取所有实体
func listEntities(client *witai.Client) {
	entities, err := client.GetEntities()
	if err != nil {
		log.Fatalf("Failed to get entities: %v", err)
	}
	
	for _, entity := range entities {
		fmt.Printf("Entity: %s (role: %s)\n", entity.Name, entity.Role)
	}
}

// 创建新实体
func createEntity(client *witai.Client, name, role string) {
	err := client.CreateEntity(&witai.Entity{
		Name: name,
		Role: role,
	})
	if err != nil {
		log.Fatalf("Failed to create entity: %v", err)
	}
}

完整示例

package main

import (
	"fmt"
	"log"
	"os"
	"github.com/wit-ai/wit-go"
)

func main() {
	client := witai.NewClient("YOUR_SERVER_ACCESS_TOKEN")
	
	// 示例1: 文本消息处理
	getIntent(client, "Turn on the lights in the kitchen")
	
	// 示例2: 语音识别 (需要准备audio.wav文件)
	// speechToText(client, "audio.wav")
	
	// 示例3: 管理应用
	getAppInfo(client)
	
	// 示例4: 管理意图
	listIntents(client)
	createIntent(client, "turn_off")
	
	// 示例5: 管理实体
	listEntities(client)
	createEntity(client, "room", "location")
}

注意事项

1. 确保你的Wit.ai服务器访问令牌是正确的
2. 对于语音识别，音频文件格式必须是Wit.ai支持的格式(如WAV、MP3等)
3. API调用有速率限制，注意处理错误和重试
4. 生产环境中应该添加适当的错误处理和日志记录

wit-go库提供了对Wit.ai API的完整覆盖，你可以根据项目需求选择使用不同的功能模块。更多详细用法可以参考官方文档和源代码。