mstratman / apiai-java-sdk

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Java SDK for api.ai

Release status Maven Central

The API.AI Java SDK makes it easy to integrate speech recognition with API.AI natural language processing API on Android devices. API.AI allows using voice commands and integration with dialog scenarios defined for a particular agent in API.AI.

Authentication is accomplished through setting the client access token when initializing an AIConfiguration object. The client access token specifies which agent will be used for natural language processing.

Note: The API.AI Java SDK only makes query requests, and cannot be used to manage entities and intents. Instead, use the API.AI user interface or REST API to create, retrieve, update, and delete entities and intents.

Tutorial

This section contains a detailed tutorial how to work with libai. This tutorial was write for IntelliJ IDEA.

Quick Start

  1. Create an API.AI agent with entities and intents, or use one that you've already created. See the API.AI documentation for instructions on how to do this.
  2. Open IntelliJ IDEA.
  3. From the start screen (or File menu) , choose Open....
    Open project
  4. In the Open project dialog, fill Path to apiai-java-sdk directory, then expand exmaples directory and choose one of the client example. Then click Ok.
    Open project dialog
  5. Open Run, choose Edit Configuraion. In the Run/Debug Configuration Dialog fill Programm arguments your Client access token
    Api keys
  6. If there are no errors, you can get the result using Idea Input/Output to make text request (text-client).

Work with library source code

If you want work with library source code, for some reason. You should to do this steps.

  1. First of all make all steps of Quick Start. Only after that do steps below.
  2. Open File, choose Project Structure..., choose Modules. Add new module libai. After this choose text-client(or voice client) module. Remove Maven: ai.api.libai:1.1.0 and Add Module dependency libai. After this click Apply.
    ProjectStructure
  3. Try to Run. If there are no errors, you can get the result using Idea Input/Output to make text request (text-client).

About

License:Apache License 2.0


Languages

Language:Java 72.1%Language:Protocol Buffer 27.9%