AIアシスタントを活用したTenjin SDK実装ガイド：開発者向け

モバイルデベロッパーとして、私たちはAIアシスタントに頼ることにすっかり慣れてしまいました。ClaudeやChatGPT、GitHub Copilotを開き、作りたいものを説明すれば、数秒で動作するコードが手に入ります。しかし、その便利さには隠れた代償があります。それはh「hallucination（幻覚）」です。

問題はここにあります。LLMにモバイル SDKの実装を依頼するとき、あなたはモデルが数ヶ月前、あるいは数年前のトレーニングデータに依存するよう求めているのです。対象となる SDK は、モデルの知識カットオフ以降に大きく進化している可能性があります。APIは変更され、メソッドは非推奨になり、新しいパターンが登場しています。しかし、AIはそれを知りません。 もっともらしく見えるものの、 現在のSDKバージョンと根本的に互換性のないコードを自信満々に出力します。 

これこそが、私たちが正面から取り組んでいる核心的な課題です。Tenjin、あるいは急速に進化するSDKをAIアシスタントを通じて実装するということは、存在しないメソッドをデバッグしたり、非推奨になった呼び出しを追いかけ回したりすることを意味するべきではありません。だからこそ、私たちはより良い方法を構築しました。

現実：LLMとSDKは相性が良くない

具体的なシナリオで考えてみましょう。 

新しいReact Nativeプロジェクトを始め、分析と アトリビューションのためにTenjinを統合したいとします。Claudeを開いて、単純な質問をします。「React NativeプロジェクトにTenjin SDKを追加して」。

トレーニングデータ（2024年初頭のTenjin SDKバージョン1.4.0を含む可能性がある）に基づいて、次のようなコードを生成します： 

import { NativeModules } from 'react-native';
const Tenjin = NativeModules.Tenjin;
Tenjin.initialize('YOUR_API_KEY');
Tenjin.connect();

import { NativeModules } from 'react-native';
const Tenjin = NativeModules.Tenjin;
Tenjin.initialize('YOUR_API_KEY');
Tenjin.connect();

一見もっともに見えますが、落とし穴があります。現在のReact Native Tenjin SDK（仮に1.8.0とします）には破壊的変更が含まれています。initializeメソッドは現在、特定の設定パラメータを持つオブジェクトを必要とするため、単純な文字列ベースのアプローチは機能しなくなっています。コードは問題なくコンパイルされますが、実行時には初期化が静かに失敗します。何時間もデバッグに費やしても、SDKが実際には初期化されていなかったことに気づかないかもしれません。

同じ罠はAndroidにも存在します。LLMにTenjinの初期化方法を尋ねると、非推奨となった tenjinSDK.init()method. を提案するかもしれません。これはバージョン1.17.0でビルダーパターンに置き換えられたメソッドです。コードは正しく見え、ビルドも成功しますが、テストしても何もトラッキングされません。初期化呼び出しがデッドコードになっているからです。 

これはAIの失敗ではなく、構造上の限界です。LLMはTenjinの最新のAPIサーフェスに関するリアルタイムの知識を持っていません。今月のリリースノートを知ることはおろか、将来の変更についても知る由もありません。モデルはトレーニングされた通りの動作、つまりコーパスに対するパターンマッチングを行い、表面上は正しいコードに似たものを生成しているにすぎません。

このギャップを埋めるには、AIアシスタントを使ってSDKを統合することです。

解決策：構造化されたAIアシスタントガイド

Tenjinはこの問題を予見し、SDK用のAIアシスタントガイド「LLM SDK Guides」を公開し始めました。  

• AIアシスタントガイドとは？
  AIアシスタントガイドとは、言語モデル向けに書かれたドキュメント（スキルと呼ばれることもあります）であり、AIアシスタントに機械可読な信頼できる情報源を提供します。APIシグネチャ、統合ルール、既知の落とし穴などが含まれます。 

これらは人間向けではなく、言語モデルが消費するために作られた指示です。明示的なルール、最新の API シグネチャ、避けるべきアンチパターンが詰め込まれています。最も重要なのは、SDK自体と一緒にバージョン管理されているため、常に最新バージョンを反映していることです。乖離も推測もありません。 

各Tenjin LLM SDKガイドには以下が含まれます： Tenjin LLM SDK ガイド 内容： 

こうしたガイドのいずれかをLLMに入力すると 以前 助けを求めることで、モデルの文脈が変化します。古くなった学習データに頼るのではなく、信頼できる情報源から情報を引き出せるようになるのです。. 

幻覚が完全に消えるわけではありませんが、発生する可能性は大幅に低くなります。LLMはもはや、矛盾する学習例の間を補間することはなく、信頼できる情報源を得ているからです。.

これこそが、見た目が正しいコードと、実際に正しいコードとの違いなのです。.

AIアシスタントの使い方：TenjinのLLM SDKガイド

以下は、TenjinのLLMガイドをSDK実装プロセスに活用する実際のワークフローです。

新しいReact Nativeプロジェクトを作成し、Tenjin分析を追加したいとします。従来の方法ではREADMEをざっと読んだり、AIアシスタントに直接質問したりするところですが、ここではより意図的なアプローチを取ります。

ステップ1：LLM SDKガイドを準備する 

Claude（または類似のツール）を開く前に、Tenjinのリポジトリからプラットフォーム判別ガイドを取得します。これはアシスタントに指示を与えるエントリーガイドです。 

ステップ 2：クロードまたはその他の AI アシスタントにプロジェクトの背景を伝える 

Claudeを開き、プロジェクトの構造と依存関係を貼り付けてください。このガイドに基づいて、Claudeはお客様の環境に適したプラットフォーム固有のガイドを特定します。. 

ステップ3：プラットフォームごとのガイダンスを提供する

この段階で、Claudeがリクエストするか、あるいはユーザーが自らプラットフォーム固有のガイドを提供します。Claudeはそれを読み込み、そのプラットフォームにおける正確なメソッドのシグネチャや初期化コードを学習します。.

ステップ 4: クロードに統合用のコードを生成させる

「LLM SDKガイド」を参考に、Claudeが統合コードを生成します。古いAPIをでっち上げることはありません。ガイドがあれば、存在しないメソッドを勝手に作り出すこともありません。.

Claudeやその他のAIアシスタントでは、以下の機能が利用可能になりました： 

• なぜこれが正しいアプローチなのかを説明してください 
• 各手順の根拠については、ガイドを参照してください 
• よくある間違いについて注意喚起します

その結果、信頼できる統合コードが完成します。これは、推測ではなく、最新のSDKとスコープに基づいて構築されています。.

例：依存性注入を用いた SDK 統合ガイドの利用方法

Androidの具体的な例として、既存のアーキテクチャにTenjinを統合する方法をご紹介します： 

Kotlinと依存性注入用のDagger2を使用してAndroidアプリを開発しており、アプリケーションの起動時にTenjinを初期化したい場合を想定します。 LLM SDKの統合ガイドを活用すれば、Claudeは最新情報を提供し、どのGradle依存関係を追加すべきかを教えてくれます。さらに、実行すべき正確な初期化手順も示してくれます。. 

SDKガイドで気づきにくいバグを見つけ出す

AIアシスタントガイドを利用する隠れたメリットの一つは、見落としがちな統合上のバグを発見できることです。n イベントトラッキングに関しては、 String そして、ある Int これは些細ですが、重大なエラーです。AIアシスタントガイドを参照すると、Claudeはどのメソッドのシグネチャが正しいかを正確に把握し、正しく動作するコードを生成します。.

AIアシスタントのガイドに独自の文脈を追加する

AIアシスタントガイドは強力ですが、あらゆるプロジェクトで活用できるよう設計されているため、その性質上、汎用的なものとなっています。プロジェクトごとに仕様、背景、範囲が異なるため、このガイドを各プロジェクトに合わせて適宜組み合わせて活用することが望ましいでしょう。. 

その方法は？ 現在の環境やサービスにTenjinを統合する方法や、特定の要件に合わせて初期化を最適化する方法については、ぜひクロードにお尋ねください。信頼性の高い「真実の源」と、自社のコードベースに合わせてカスタマイズされたソリューションという、両方のメリットを享受できます。. 

デバッグ用 SDK ガイドの使い方

SDK統合ガイドは、単に構築を行うためだけのものではありません。統合に問題が生じた際にも、非常に役立つものです。.

当て推量をする代わりに、ガイドのテストチェックリストと検証セクションをClaudeに提示します。マニュアルを参照しながら、Claudeはよくある設定ミスを指摘し、問題の発生箇所を正確に特定できるまで、検証手順を系統立てて案内してくれます。. 

AI対応SDKへの移行

AI時代のドキュメント作成を見直しているのは、Tenjinだけではありません。RevenueCatは、LLMが自社のサブスクリプションSDKを正しく扱えるよう、AIに特化したガイドを公開しています。 OneSignalは、モデルがプッシュ通知APIについて誤った情報を生成しないよう、SDK用のAIプロンプトを整備しています。この分野で最も先進的なチームは皆、ドキュメントの読者層が現在2つあることに気づいています。そのうちの1つは人間ではないのです。. 

これはすべてを一変させるものです。長年にわたり、「優れたドキュメント」とは、人間が理解できるドキュメントを指していました。しかし今では、適切にメンテナンスされたライブラリは、Markdownを流暢に使いこなし、世の中の統合コードの半分を記述しているAIアシスタントとコミュニケーションをとらなければなりません。READMEファイルやチュートリアルがなくなるわけではありませんが、もはやそれらは主役の座から降りることになりました。. 

1年以内に、「AIアシスタントガイド」は主要な提供成果物となり、すべてのSDK、ドキュメント、コードサンプルと併せて提供されるようになります。. 

主要な結論

ここから得られる主な教訓は単純です： 最新のリファレンス資料がない状態で、LLMにSDKの統合を任せてはいけません。. モデルのトレーニングデータはデフォルトで古くなっていることが多く、古いAPIを使用することによるコストは、ほとんどの場合、一目でわかるものではありません。これは通常、コンパイルは問題なく通るものの、何の前触れもなくエラーが発生し、何時間も無駄にしてしまうようなバグです。TenjinのLLMガイドは単なるオプションのドキュメントではなく、統合ワークフローにおいて不可欠なツールとなっています。.

AIアシスタントに「Tenjin」についてサポートを依頼する前に、次の3つのことを行ってください： 

1. ガイドを取りに行って、持ってきてください。.

このたった一つの手順により、幻覚が劇的に減少し、モデルは「推測」から「信頼できる情報源に基づく推論」へと移行する。. 

2. プロジェクト固有のコンテキストを組み込んでください。.

ガイドがSDKの対応を担当し、お客様には、プロジェクト全体の仕様や範囲に基づくアーキテクチャ上の制約、パフォーマンス要件、および統合ポイントをご提示いただきます。. 

3. 毎回、ガイドと照らし合わせて出力を確認してください。.

LLMを信頼している場合でも、参考文献や出典と照らし合わせて手短に確認しておけば、デバッグやトラブルシューティングにかかる時間を何時間も節約できます。. 

開発者向けツールの将来像は、ますます明確になってきています。つまり、人間がルールを作成し、機械がそれに従い、開発者はその双方の恩恵を受けるという構図です。.

テンジンでは、いち早く取り組みを始め、率先して模範を示しています。. こちらでスキルファイルをご覧いただけます AIアシスタントと併用して、当社のSDKを統合することができます。.

この記事は、TenjinのシニアSDKエンジニアであるエンリケ・ロペス＝マニャスによって執筆されました。.