Skip to main content

​
Stack Exchange

ShanoneのStack Exchange連携は、質問の検索、回答/コメント/バッジの閲覧、タグの参照、そして(認証済みの書き込みアクセスがある場合の)質問/回答/コメントの投稿と投票を、Stack Overflowをはじめとする任意のStack Exchangeサイトに対して行う82個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにStack Exchange関連の作業を依頼(例: 「Reactフックをデバウンスする方法をStack Overflowで検索して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Stack Exchangeアカウントを許可する

OAuth同意画面を承認します。Application KeyとDefault Site(例: stackoverflow)を任意で設定できます——キーを設定すると、1日あたりのリクエスト上限が300から10,000に上がります。
3

リクエストを再実行する

接続が完了すると、stackexchange_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。Application Keyが設定されていれば、完全なOAuthなしでも読み取り専用ツールは動作します。

​
利用可能なツール

ShanoneはStack Exchange向けに82個のツールを、以下のカテゴリに整理して提供しています。
stackexchange_list_answers, stackexchange_get_answers_by_ids, stackexchange_get_answers_for_questions, stackexchange_get_questions_by_answer_ids, stackexchange_get_comments_on_answers
stackexchange_list_posts, stackexchange_get_posts_by_ids, stackexchange_get_comments_on_posts, stackexchange_list_comments, stackexchange_get_comments_by_ids, stackexchange_get_revisions_by_post_ids, stackexchange_get_revisions_by_guids, stackexchange_get_suggested_edits_on_posts, stackexchange_list_suggested_edits
stackexchange_create_question, stackexchange_edit_question, stackexchange_delete_question, stackexchange_create_answer, stackexchange_edit_answer, stackexchange_delete_answer, stackexchange_create_comment, stackexchange_delete_comment, stackexchange_edit_comment, stackexchange_render_answer_preview
stackexchange_upvote_post, stackexchange_downvote_post, stackexchange_undo_vote, stackexchange_favorite_question, stackexchange_accept_answer
stackexchange_list_tags, stackexchange_get_tags_info, stackexchange_get_moderator_only_tags, stackexchange_get_required_tags, stackexchange_get_tag_synonyms, stackexchange_get_synonyms_by_tags, stackexchange_get_related_tags, stackexchange_get_tag_wikis, stackexchange_get_top_answerers_on_tags, stackexchange_get_top_askers_on_tags, stackexchange_get_faqs_by_tags, stackexchange_get_top_user_answers_in_tags
stackexchange_list_users, stackexchange_get_users_by_ids, stackexchange_get_user_answers, stackexchange_get_user_questions, stackexchange_get_user_badges, stackexchange_get_user_comments, stackexchange_get_user_favorites, stackexchange_get_user_reputation, stackexchange_get_user_reputation_history, stackexchange_get_user_tags, stackexchange_get_user_timeline, stackexchange_get_top_tags_on_users, stackexchange_get_moderators
stackexchange_list_badges, stackexchange_get_badges_by_ids, stackexchange_get_badges_by_name, stackexchange_get_badge_recipients
stackexchange_get_me, stackexchange_get_my_answers, stackexchange_get_my_questions, stackexchange_get_my_reputation, stackexchange_get_my_favorites, stackexchange_get_my_inbox, stackexchange_get_my_notifications, stackexchange_get_my_achievements
stackexchange_list_sites, stackexchange_get_site_info, stackexchange_create_filter, stackexchange_read_filters, stackexchange_list_privileges, stackexchange_list_errors

​
よくあるユースケース

回答前のリサーチ

新しいコードを書く前に、既存の回答をStack Overflowで検索する

コミュニティのモニタリング

チームが担当するタグの未回答質問を監視し、レビュー用の回答案を作成する

レピュテーションの追跡

大きな貢献の後に、ユーザーのレピュテーション履歴と最近のバッジを確認する

タグ調査

トピックに関連するタグとトップ回答者を見つけ、その分野の専門家を特定する

​
トラブルシューティング

Application Keyを設定していない場合、Stack Exchangeは1日300リクエストに制限されます。連携アプリにキーを設定すると上限が1日10,000に上がります。
多くの読み取りツールはsiteパラメータを受け取ります(デフォルトは設定済みのDefault Site)——Stack Overflow以外のサイト(例: superuserやserverfault)を検索する場合は明示的に指定してください。
書き込みや投票操作には、Application Keyだけでなく完全なOAuth認証と、対象サイトでの十分なレピュテーションが必要です——Stack ExchangeはShanoneとは独立して、投稿や投票に自身のレピュテーション閾値を適用します。