google-developer-knowledge

Google Developer Knowledge

このスキルを使用すると、Developer Knowledge API で Google の公開開発者向けドキュメントコーパスを検索し、内容を取得できます。

このスキルでは、依存関係のないシンプルな bash スクリプトと curl を使用します。

前提条件

1. API を有効にする：Developer Knowledge API を Google Cloud プロジェクトで有効にします。

2. API キーを作成する：

   • 認証情報ページに移動します
   • 認証情報を作成 → API キーをクリックします
   • キーを Developer Knowledge API のみに制限します

3. 環境変数を設定する：

   • DEVELOPERKNOWLEDGE_API_KEY：Developer Knowledge API キー

検索可能なコーパス

API は次のドメインを検索します：

• ai.google.dev
• developer.android.com
• developer.chrome.com
• developers.google.com
• docs.cloud.google.com
• firebase.google.com
• web.dev
• www.tensorflow.org

使用方法

1. ドキュメントを検索する

クエリに一致するドキュメントのチャンクを検索します。スニペットと親ドキュメントへの参照が返されます。

./skills/google-developer-knowledge/scripts/search_docs.sh "How to use Gemini API in Python"

ページネーションを使用する場合：

./skills/google-developer-knowledge/scripts/search_docs.sh "BigQuery" --page-size 10

2. 単一のドキュメントを取得する

検索結果に含まれる名前を使用して、ドキュメントの全内容を取得します。

./skills/google-developer-knowledge/scripts/get_document.sh "documents/ai.google.dev/gemini-api/docs/get-started/python"

ファイルに保存する場合：

./skills/google-developer-knowledge/scripts/get_document.sh "documents/ai.google.dev/..." --output doc.json

3. 複数のドキュメントを一括取得する

1 回の API 呼び出しで最大 20 件のドキュメントを取得します。

./skills/google-developer-knowledge/scripts/batch_get_documents.sh \
  "documents/ai.google.dev/gemini-api/docs/get-started/python" \
  "documents/ai.google.dev/gemini-api/docs/models"

オプション

search_docs.sh

• query：検索クエリ（必須）
• --page-size：結果の件数（1～20、デフォルトは 5）
• --page-token：次のページの結果を取得するためのトークン
• --output：結果を JSON ファイルに保存

get_document.sh

• name：検索結果に含まれるドキュメント名（必須）
• --output：内容をファイルに保存

batch_get_documents.sh

• names：スペースで区切ったドキュメント名（最大 20 件）
• --output：すべてのドキュメントをディレクトリに保存