Juno AI Customer Research

Juno Agent Toolkit

Juno 用のエージェントスキル、小規模な Python クライアント、実行可能なワークフローです。Juno は、実在する人々を対象とした AI モデレーター付きの顧客インタビューを提供します。

プロダクト分析、サポートチケット、既存の調査だけでは、顧客自身の説明が必要な疑問に答えられない場合に Juno をご利用ください。調査の概要を作成し、インタビューを確認して、回答を収集し、対応する API を通じて根拠を取得できます。

セルフサービス API キーと OAuth 2.1。 本番環境では、セルフサービスの Juno API キー（jsk_live_… / jsk_test_…）と、動的クライアント登録および PKCE S256 を使用した OAuth 2.1 に対応しています。ネイティブ MCP クライアント（Claude Code、OpenAI Codex、ChatGPT）は、OAuth またはベアラーキーを使用して直接接続できます。この Python ツールキットは JUNO_API_KEY を使用し、サインアップや認証情報の発行には対応していません。Juno のリモート MCP サーバーは、公式 Model Context Protocol レジストリに io.github.hey-juno/juno として登録されています（server.json）。テスト済みの項目と制限事項については、検証と制限事項をご覧ください。

インターフェースを選ぶ

インターフェース	用途	こちらから始める
エージェントスキル	スキルに対応したアシスタントに、承認済みの調査タスクで Juno を使う方法を教える	Juno 調査スキル
Python クライアント	アプリケーションまたはエージェントから Juno を呼び出す	クライアントと以下のクイックスタート
MCP	互換性のあるクライアントを Juno のホスト型ツールに接続する	MCP 接続ガイド
調査ワークフロー	概要の作成から参加者の根拠の取得まで、調査を進める	ワークフローと実行可能な例

Python クイックスタート

Python 3.11 以降が必要です。サードパーティの実行時依存関係はありません。このリポジトリをクローンし、ルートディレクトリから実行します。

git clone https://github.com/hey-juno/juno-agent-toolkit.git
cd juno-agent-toolkit
python -m examples.research_workflow --help

通常のシークレット管理方法を使って、環境に JUNO_API_KEY を設定してください。ソースファイル、プロンプト、コミット対象のクライアント設定、または課題報告に記載しないでください。

import os
from juno_client import JunoClient

client = JunoClient(api_key=os.environ["JUNO_API_KEY"])
identity = client.me()
print(identity["org_id"], identity["scopes"])

ユーザーが調査の作成を承認している場合：

python -m examples.research_workflow draft \
  --guidance "Understand why customers abandon onboarding and what they expected instead."

新しい調査はテストモードで開始されます。本番公開を選択する前に、概要を確認してください。この例では、下書きの作成、本番公開、インタビューの確認、結果のエクスポートを個別に行います。参加者を自動的に募集したり、連絡したりすることはありません。

このクライアントが対応するのは、調査と根拠に関する主要なワークフローであり、公開 API のすべての操作ではありません。最新の REST リファレンスとOpenAPI ドキュメントで、インターフェース全体を定義しています。このプレビューは GitHub から配布されており、PyPI には公開されていません。

エージェントが取得できる情報

調査およびインタビューのエンドポイントから、ステータスとメタデータを取得できます。インタビューのメタデータにトランスクリプトは含まれません。 ライブモードで完了したインタビューについては、組織の権限と墨消し設定に従い、エクスポートワークフローを使用して CSV 形式のトランスクリプトと回答を取得してください。テストモードのシミュレーションはリハーサル用であり、顧客の根拠ではありません。

調査の概要、参加者の引用、トランスクリプトの文脈を使って調査結果を説明してください。不確実性や相反する見解は明示してください。Juno は、少数の定性サンプルから、母集団全体における割合や測定された因果効果を導き出すものではありません。

公開 MCP、ホスト型サービス

Juno は https://api.heyjuno.co/v1/mcp/ にリモート MCP エンドポイントを公開しています。公開されている接続情報によって検出可能になりますが、利用には認証情報とワークスペースの権限が必要です。クライアントの設定と検証状況については、接続ガイドをご覧ください。

このリポジトリには、クライアント側の統合資料が含まれています。ホスト型 MCP サーバーと Juno の調査エンジンは、引き続き Juno サービスの一部です。ここには、別の MCP サーバー、ローカルプロキシ、セルフホスト可能な Juno バックエンドはありません。

実際のリサーチ事例

• StoryTribe：コンバージョンを妨げる要因の発見
• OFX：顧客のジャーニーを可視化
• The Arthritis Movement：コミュニティの声を政策に反映
• オーストラリアの気候変動に対する意識調査

これらは公開されている顧客事例であり、このクライアントのフィクスチャやベンチマーク結果ではありません。

開発

python -m unittest discover -s tests -v

テストではローカル HTTP サーバーと合成データを使用します。Juno やモデルの API キーは不要で、実際のリサーチも作成されません。契約の来歴では、公開スキーマのスナップショットについて説明しています。再現可能なクライアントの問題は、認証情報とリサーチデータを削除したうえで GitHub に報告してください。アカウントや非公開データに関する問題については、Juno サポートをご利用ください。

このツールキットはMIT ライセンスで提供されています。ホステッドサービスへのアクセスには、Juno の現行の利用規約と利用資格が適用されます。