はじめに

docomo Developer support では，さまざまな開発者向けAPIが公開されています．その中の自然対話API を使用すると，誰でも対話型サービス（無償提供サービスに限定）を自然言語処理技術の知識なしに開発することができます．
自然対話APIは，下記の5つのAPIから構成されています．

意図解釈API
FAQチャットAPI
雑談対話API
知識検索API
キャラクタ変換API

今回は，自然対話APIのうち，雑談対話APIとキャラクタ変換APIを使って，Python3で動く，愛媛県今治市弁を話すチャットボットを作ってみたいと思います．
雑談対話APIからのレスポンスのシステム発話を，をキャラクタ変換APIにリクエストとして送ることで，キャラクタ風の発話に変換します．

準備

docomo Developer support のアカウントをお持ちでない方は，新規登録が必要です．
docomo Developer support にログインし，自然対話API > 雑談対話API・キャラクタ変換APIのAPIの利用申請を行います．
アプリケーション登録の画面で必要事項を入力後，API機能選択の画面で，雑談対話APIとキャラクタ変換APIの利用にチェックを入れます．

API利用申請が完了すると，マイページ > API利用申請・管理からAPI keyが確認できます．

チャットボットの作成

pythonから雑談対話APIとキャラクタ変換APIを呼び出し，コマンドライン上で動作するチャットボットを構築します．

雑談対話APIのユーザ登録

雑談対話APIを利用するために，ユーザー情報を登録してappIdを取得する必要があります．
appIdは，ユーザ毎の会話のステータスを管理するのに用いられています．
複数のユーザで同じappIdを使用してしまうと，別のユーザの対話の状態が引き継がれてしまうため，ユーザ毎にappId取得するようにしてください．
ユーザ登録のエンドポイント（https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/registration）に対してリクエストを送ると，レスポンスとしてappIdを取得できます．
下記はユーザ登録を行うpython3のサンプルプログラムです．

chatting_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
url = "https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/registration?APIKEY="+chatting_KEY
header = {"Content-type": "application/json;charset=UTF-8"}
request = {
    "botId": "Chatting",
    "appKind": "Smart Phone"
}
response = requests.post(url, data=json.dumps(request), headers=header)
chatting_appId = response.json()["appId"]

雑談対話API

雑談対話APIのエンドポイント（https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/dialogue）に対してリクエストを送ると，レスポンスとしてシステム発話を取得できます．
下記は雑談対話を行うpython3のサンプルプログラムです．

chatting_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
url = "https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/dialogue?APIKEY="+chatting_KEY
header = {"Content-type": "application/json;charset=UTF-8"}
request = {
    "language": "ja-JP",
    "botId": "Chatting",
    "appId": chatting_appId,
    "voiceText": user_utt,
    "clientData":{
    "option":{
      "mode":"dialog"
      }
    },
    "appRecvTime": "", 
    "appSendTime": ""
}
response = requests.post(url, data=json.dumps(request), headers=header)
system_utt = response.json()["systemText"]["expression"]

modeを"srtr"にすると，しりとりを行うことができます．
しりとりを継続する場合は，レスポンスのmode（srtr）をリクエストボディのmodeに指定します．
レスポンスのmodeは，Base64 URLエンコーディングされていますので，デコードした値を指定してください．

キャラクタ変換APIのユーザ登録

キャラクタ変換APIを利用するために，ユーザー情報を登録してappIdを取得する必要があります．
ユーザ登録のエンドポイント（https://api.apigw.smt.docomo.ne.jp/naturalCharaConv/v1/registration）に対してリクエストを送ると，レスポンスとしてappIdを取得できます．
下記はユーザ登録を行うpython3のサンプルプログラムです．

chara_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
url = "https://api.apigw.smt.docomo.ne.jp/naturalCharaConv/v1/registration?APIKEY="+chara_KEY
header = {"Content-type": "application/json;charset=UTF-8"}
request = {
    "botId": "CharaConv",
    "appKind": "Smart Phone"
}
response = requests.post(url, data=json.dumps(request), headers=header)
chara_appId = response.json()["appId"]

キャラクタ変換API

キャラクタ変換APIのエンドポイント（https://api.apigw.smt.docomo.ne.jp/naturalCharaConv/v1/dialogue）に対してリクエストを送ると，レスポンスとして方言・指定キャラクタ風の話し方に変換されたテキストを取得できます．
下記の13種類のキャラクタが指定でき（なぜか愛媛弁が多い気がしますね），clientData > option > t の値にキャラクタIDを設定します．

ehime1：愛媛県今治市弁
ehime2：愛媛県四国中央市弁
ehime3：愛媛県松山市弁
kansai：関西弁
hakata：博多弁
fukushima：福島弁
mie：三重弁
maiko：舞妓風
ojo：お嬢様風
bushi：武士風
gyaru：ギャル風
burikko：ぶりっ子風
akachan：赤ちゃん風

今回は愛媛県今治市弁に変換するので， t の値に "ehime1" を設定します．
下記はキャラクタ変換を行うpython3のサンプルプログラムです．

chara_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
url = "https://api.apigw.smt.docomo.ne.jp/naturalCharaConv/v1/dialogue?APIKEY="+chara_KEY
header = {"Content-type": "application/json;charset=UTF-8"}
request = {
    "language": "ja-JP",
    "botId": "CharaConv",
    "appId": chara_appId,
    "voiceText": system_utt,
    "clientData":{
        "option":{
            "t":"ehime1"
        }
    },
    "appRecvTime": "", 
    "appSendTime": ""
}
response = requests.post(url, data=json.dumps(request), headers=header)
converted_system_utt = response.json()["systemText"]["expression"]

ボットと対話してみよう

これまでのサンプルプログラムをまとめて，コマンドライン上で動作するチャットボットを構築します．

# -*- coding: utf-8 -*-

import requests
import json

# APIkey
chatting_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
chara_KEY = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"


# 雑談APIユーザ登録
def registration_chatting():
    url = "https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/registration?APIKEY="+chatting_KEY
    header = {"Content-type": "application/json;charset=UTF-8"}
    request = {
        "botId": "Chatting",
        "appKind": "Smart Phone"
    }
    response = requests.post(url, data=json.dumps(request), headers=header)
    chatting_appId = response.json()["appId"]
    return chatting_appId


# 雑談対話APIに接続
def chatting(chatting_appId, user_utt):
    url = "https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/dialogue?APIKEY="+chatting_KEY
    header = {"Content-type": "application/json;charset=UTF-8"}
    request = {
        "language": "ja-JP",
        "botId": "Chatting",
        "appId": chatting_appId,
        "voiceText": user_utt,
        "clientData":{
        "option":{
          "mode":"dialog"
          }
        },
        "appRecvTime": "", 
        "appSendTime": ""
    }
    response = requests.post(url, data=json.dumps(request), headers=header)
    system_utt = response.json()["systemText"]["expression"]
    return system_utt


# キャラクタ変換APIユーザ登録
def registration_characonv():
    url = "https://api.apigw.smt.docomo.ne.jp/naturalCharaConv/v1/registration?APIKEY="+chara_KEY
    header = {"Content-type": "application/json;charset=UTF-8"}
    request = {
        "botId": "CharaConv",
        "appKind": "Smart Phone"
    }
    response = requests.post(url, data=json.dumps(request), headers=header)
    chara_appId = response.json()["appId"]
    return chara_appId


# キャラクタ変換APIに接続
def characonv(chara_appId, system_utt):
    url = "https://api.apigw.smt.docomo.ne.jp/naturalCharaConv/v1/dialogue?APIKEY="+chara_KEY
    header = {"Content-type": "application/json;charset=UTF-8"}
    request = {
        "language": "ja-JP",
        "botId": "CharaConv",
        "appId": chara_appId,
        "voiceText": system_utt,
        "clientData":{
            "option":{
                "t":"ehime1"
            }
        },
        "appRecvTime": "", 
        "appSendTime": ""
    }
    response = requests.post(url, data=json.dumps(request), headers=header)
    converted_system_utt = response.json()["systemText"]["expression"]
    return converted_system_utt


if __name__ == "__main__":
    chatting_appId = registration_chatting()
    chara_appId = registration_characonv()
    
    while True:
        user_utt = input("User> ")
        if user_utt == "exit":
            break
        else:
            system_utt = chatting(chatting_appId, user_utt)
            converted_system_utt = characonv(chara_appId, system_utt)
            print("System> %s" % converted_system_utt)

コマンドラインで実行すると，下記のような感じで対話でき，exitを入力すると対話が終了します．
※雑談対話APIではレスポンスまで10秒程度かかりますので，ユーザ発話入力後，応答があるまでしばらくお待ちください．

愛媛県今治市弁のボット，なかなか可愛くないでしょうか？
愛媛弁以外にも様々なキャラクタが設定できるので，ぜひいろいろ試してお気に入りを見つけてください．

おわりに

自然対話APIのうち，雑談対話APIとキャラクタ変換APIを使って，Python3で動く，愛媛県今治市弁を話すチャットボットを作ってみました．
APIにリクエストを送るだけなので，お手軽にチャットボットが作成できます．
SlackやTelegramなどと連携すれば，よりチャット感が出るかと思います．
docomo Developer support の自然対話APIでは，他にも様々な機能のAPIを公開しておりますので，いろいろ組み合わせて，ぜひお好みのチャットボットを構築してみてください．

また，2018年10月1日より，商用雑談対話サービス「katarai」がリリースされています．カスタマイズにも対応しておりますので，ご興味ある方はぜひ見てみてください．