ぼっと勉強会 (H22/09/25)

• ぼっとを作ろう！
  
• ……でも難しいんでしょう？
  
• 簡単にぼっとを作れるひな形を用意しました！！
  
• ただし、凝ったことはできないよ
  
• ぼっとを改造したい場合はプログラミングを習得しましょう！
  

• ぼっとの仕組みについて
  
• 下準備（環境設定）
  
• ひな形の説明
  
• プログラミングについて
  

• よのぼっと = Web サイト
  
• http://yonobot.appspot.com
  
  • /tweet -> ついったーにつぶやく
    
  • /reply -> リプライを返す
    
  • /learn -> ログから学習する
    
• これらのページに定期的にアクセスすることで動かしている
  

• 自宅PC
  
  • 好きに設定できる
  • PC の電源を落とすとぼっとも死ぬ
  • Windows だと面倒かも
• レンタルサーバー
  
  • 最低限の設定はされている
  • 制限あり
  • ぼっとを動かすための準備が必要

• Google App Engine
  
  • Google が提供するサービス
    
  • プログラムを動かす環境
    
  • 無料
    
  • 登録が必要
    
  • 自分の PC にも設定が必要
    
• 今回は Google App Engine を利用してぼっとを作成します
  

• Google のアカウント作成
  
  • Gmail の設定（あると便利）
    
  • Google App Engine への登録
    
    • 携帯のメールアドレスが必要
      
• Twitter のアカウント作成
  
  • メールアドレスが必要
    
• Twitter のアプリケーション登録
  

http://www.google.co.jp/

たしか Google のアカウント持ってたら使えたと思います

• なぜ Gmail か？
  
  • Twitter アカウント作成にはメールアドレスが必要
  • 通常は 1 メールアドレスで 1 アカウント
  • Gmail だと 1 メールアドレスでいくらでもアカウントが作成できます
• 作り方
  
  • 例: yono@gmail.com というメールアドレスを使う場合
  • Twitter 登録時に yono+bot@gmail.com というアドレスを入力します
  • これだけ
  • + 以降の文字を変えればいくらでもアカウントが作れます

http://twitter.com

ぼっと用のアカウントでログインし、画面上部の 「設定」をクリック

「連携アプリ」をクリック

赤丸で囲まれた部分の「こちら」をクリック

「新しいアプリケーションを追加」をクリック

「アプリケーションの種類」は「クライアントアプリケーション」を選択

「Default Access type:」は「Read & Write」を選択

それ以外は特に入力する必要はありません

• Python のインストール
  
  • プログラミング言語
  • よのぼっとはこの言語で書かれています
• Google App Engine SDK のインストール
  
  • Google App Engine で開発するためのツール
• サクラエディタのインストール
  
  • ファイルを編集する際に使います

http://www.python.org/download/releases/2.5.4/

お使いのPCに合ったインストーラをダウンロードしてください

通常のアプリケーションのインストーラと同様です。

特に設定変更する箇所はありません

特に設定変更する箇所はありません

特に設定変更する箇所はありません

Finish をクリックしてインストールを完了します

http://code.google.com/intl/ja/appengine/downloads.html 「GoogleAppEngine-1.3.7.msi」をクリック

通常のアプリケーションのインストーラと同様です。

特に設定変更する箇所はありません

I accept… にチェックを入れて Next をクリック

特に設定変更する箇所はありません

Install をクリックしてインストールを完了します

http://mofmof.nsf.tc/soft/sakura_unicode/

sakuraW_r1428.zip をクリックしてダウンロード

ダウンロードしてファイルを展開するとsakuraWというアプリケーションが 入っています。

ダブルクリックして一度起動すると、右クリックメニューに [SAKURAで開く]が追加されます。

ファイルを右クリックして[SAKURAで開く]を選択すると サクラエディタでファイルを開くことができます。

以降、テキストファイルを編集する際はこのアプリケーションを 使用します。

• 二種類のつぶやきパターン
  
  • 自動的に生成した文章をポスト
    
    • よのぼっとと同じ
    • ついったーのアカウントを基に作成
  • あらかじめ用意した文章をポスト
    
    • ファイルに書かれた文章をランダムにポスト
• リプライに対する返信
  
  • ON, OFF の切り替え

• OAuth のキー入手
  
• ツールを入手し、動作確認
  
• アップロードしてぼっととして動かす
  

• Twitter が扱う認証形式
  
• パスワードの代わりに四種類のキーを使う
  
  • consumer_key（アプリケーションごと）
    
  • consumer_secret（アプリケーションごと）
    
  • access_token（ユーザごと）
    
  • access_token_secret（ユーザごと）
    
• パスワードを教えないのでよいのでより安全
  
• ただし手順が少し面倒
  

• 説明
  
  • (1) ユーザがサービスの利用申請をする
  • (2) サービスが Twitter にユーザアカウントの利用許可を求める
  • (3) Twitter がユーザに確認し、OK であれば PIN 番号を渡す
  • (4) ユーザはサービスに PIN 番号を伝える
  • (5) サービスは Twitter に PIN 番号を伝える
  • (6) access_token, access_token_secret が渡される

  

• ぼっとを動かすためには前述の四種類のキーが必要です
• 前述の手順だと面倒なので、Webサイトからダウンロードする方法を使います

http://dev.twitter.com にアクセス

Sign In（ぼっとのユーザ名とパスワード入力）

[Your apps] をクリック

先ほど作成したアプリケーションを選択

画面下部へスクロール

consumer_key と consumer_secret を記録しておいてください

画面上部へ戻って[My Access Token]をクリック

access_token と access_token_secret を記録しておいてください

http://github.com/yono/gae-twibot

赤丸で囲まれている「ダウンロード」をクリック

ZIP をダウンロードする

• ダウンロードしたファイルを展開する
• 中にフォルダが入っているので、取り出して My Documents 以下に置く （絶対パスに日本語が含まれるとぼっとが動作しません）

• 先ほど取り出したフォルダを開きます
• config.ini.sample というファイルをコピーして、 config.ini というファイルを作ります

• config.ini を開きます
• 先程保存した4つのキーを入力し、保存します

Google App Engine Launcher を開く

[File] - [Add Existing Application] をクリック

Application 選択画面が表示される

さきほど取り出したフォルダを選択し、OK をクリック

Add をクリック

左上の [Run] をクリック

左側のアイコンが変わったのを確認

Browse をクリックして動いているか確認する

Hello World! と表示されたら成功

ブラウザで http://localhost:8080/tweet にアクセスします

• 新しいウィンドウ（タブ）を開き、 http://twitter.com/<ぼっとのアカウント> を開きます
• つぶやきが投稿されていたら成功です

• 編集するファイル
  
  • app.yaml -> GAE の設定
    
  • config.ini -> ぼっとの設定
    
  • cron.yaml -> 発言する間隔、reply に反応する間隔の設定
    
  • main.py -> ぼっと本体
    
  • sentence.txt -> ぼっとの発言が書かれたファイル
    
• 特に触らないでよいファイル
  
  • lib -> ぼっと用のライブラリ
  • twilog -> 同上
  • twoauth -> 同上
  • .gitignore -> Git（バージョン管理システム）用のファイル
  • index.yaml -> GAE 用。自動生成される
  • markov.py -> ぼっと用のライブラリ
  • README.mkdn -> 説明書

• 機能
  
  • ツイートを投稿する
    以下の二つから選択できます
    • 1. ファイル（sentence.txt）に書かれた文章をランダムにツイート
    • 2. マルコフ連鎖により自動生成した文章をツイート

    デフォルトは 1. です

  • リプライに対して返信する
    

sentence.txt に書かれた文をランダムにツイートします。

文の区切り文字は % です。

例を以下に示します。

「こんにちは」「ねむい」「あつい」のいずれかをランダムに ツイートします。

こんにちは
%
ねむい
%
あつい

cron.yaml を開いて以下の部分を変更

cron:
- description: tweet
  url: /tweet
  # ツイートの間隔
  schedule: every 15 minutes # <- ここ

15 となっている部分がつぶやく間隔（単位: 分）

この部分を変更すると、つぶやく間隔が変更されます。

注: 半角で入力すること

• リプライに返信するかどうかを変更します
  
• http://localhost:8080/settings
  

cron.yaml を開いて以下の部分を変更する

- description: reply
  url: /reply
  schedule: every 1 minutes # <- ここ

1 となっている部分がリプライに反応する間隔（単位: 分)

この部分を変更すると、リプライに反応する間隔が変更されます。

注: 半角で入力すること

• 機能
  
  • 特定のついったーアカウントの発言を元に文章を生成します。
  • twilog から発言を収集します。
• 設定を変更するには
  config.ini を開いて以下の部分を変更

  [bot]
  tweet_type = 1 # <- ここ
  reply = True
  

  • tweet_type = 1 だと sentence.txt を使用
  • tweet_type = 2 だとマルコフ連鎖を使用

• 発言を収集するユーザを選択する
  config.ini を開いて以下の部分を変更

  [twilog]
  original_id = # <- ここ
  

  対象ユーザの Twitter ID を記入する。

  例:

  [twilog]
  original_id = yono
  

• 事前準備
  マルコフ連鎖によるツイートを行うためには

  事前に Yahoo!での登録が必要です。

  Yahoo! Japan ID を持ってない場合は別途登録が必要です。

  http://www.yahoo.co.jp

アプリケーションIDの登録

http://e.developer.yahoo.co.jp/webservices/register_application

まずはログインします

IDとパスワードを入力してログイン

メールアドレスは Yahoo のアドレスが選択済みになってます

OAuth: 利用しない、ガイドライン: 同意する、を選択

登録をクリック

アプリケーションIDを記録しておく

• アプリケーションIDを記入
  config.ini を開いて以下の部分にアプリケーションIDを記入

  [yahoo]
  appid = # <- ここ
  

• 今までの発言データを収集（一括解析）
  これまでに発言データを大量に集めている場合は、

  それらのデータをまとめて収集することができます。

  ぼっとを起動した状態で http://localhost:8080/learn_tweet_all にアクセスしてみてください。

  また、事前に Twilog (http://twilog.org) にデータが保存されているか 確認しておきましょう

アップロードすることで、自動的につぶやくようになります。

• 手順
  
  1. Google App Engine に登録してアプリケーション作成
  2. ぼっとの設定ファイルを変更する
  3. Google App Engine Launcher を使ってアップロードする

http://appengine.google.com へアクセス

Google アカウントでのログインを求められます

Create an Application をクリック

携帯のアドレスを登録します

Country and Carrier: で Japan, Select your carrier で お手持ちの携帯のアドレスの @ 以降を選択します。

Username: には 携帯アドレスの @ 以前を入力します。

例: yono@ezweb.ne.jp の場合、Select your carrier で ezweb.ne.jp,

Username: で yono をそれぞれ入力します

必要な情報を入力して Send を押すと、携帯にメールが届きます。

そこに書かれている暗証番号をブラウザに入力すると、

登録完了です。

注: メールが届かない場合、携帯のメール拒否設定を変更してください

再度 http://appengine.google.com にアクセスし、

[Create an Application] をクリックします

Application Identifier は、ぼっとをアップロードする際に必要なので

メモしておいてください。

Google App Engine Launcher を起動し、Edit をクリックします

以下の部分を、Application Identifier で設定した文字列に変更します。

変更したら保存してウィンドウを閉じます

application: yonobot_test # <- ここを変更

↓

application: twibot # <- Application Identifier が twibot の場合

Deploy をクリックします

Google に登録した Email とパスワードを入力し、OK をクリックします

完了までしばらく時間がかかります

アップロードが完了したらぼっとのアカウントに アクセスしてみましょう

http://twitter.com/*****

定期的につぶやいていれば成功です