integration-create

ADK 統合ページ作成ツール（integration-create）

このスキルは、adk-docs リポジトリ向けに、新しい統合ページを作成します。統合ページは docs/integrations/ に配置され、カードカタログに自動検出されます。このスキルの出力は完成したページではなく、質の高い出発点です。作成後は、integration-review スキルを実行し、mkdocs serve でテストしてください。

実際のテンプレートは、公開中の既存ページです。下書きを始める前に、選択したカテゴリの見本ページを開き、その構成や慣例に合わせてください。

• MCP ツール：docs/integrations/github.md、docs/integrations/notion.md
• オブザーバビリティ：docs/integrations/phoenix.md、docs/integrations/arize-ax.md
• プラグイン：docs/integrations/daytona.md、docs/integrations/goodmem.md

類似ページをさらに探すには、catalog_tags を一度に検索し（grep catalog_tags docs/integrations/*.md）、同じカテゴリタグ（例： mcp、observability）または製品ドメインを共有するページをすべて読んでください。以下のテンプレートだけから推測するのではなく、公開中のページとリポジトリの慣例に合わせてください。

人向けの要件については、CONTRIBUTING.md の「Integrations」セクションを参照してください。レビューで適用されるルールの全容については、integration-review スキルを参照してください。

Step 1: 入力情報を集める

まだ提供されていない情報をユーザーに尋ねてください。

• 製品／統合名（catalog_title と H1 に使用します）。
• カテゴリ（テンプレートを選択します）。
  • MCP ツール（エージェントが接続する MCP サーバー）
  • オブザーバビリティ（トレース／メトリクス／評価エクスポーター）
  • プラグイン（ツールまたはコールバックを提供するインストール可能なパッケージ）
• 言語サポート：Python のみ、または Python と TypeScript。
• パッケージ名（PyPI／npm）とインストールコマンド。
• MCP の接続方式：ローカル（stdio）および／またはリモート（HTTP）。
• 統合が提供するツールまたはメソッド（表に記載します）。
• リンク：製品ドキュメント、GitHub リポジトリ、PyPI／npm、API キーの取得先。
• アイコン：docs/integrations/assets/<slug>.png にアセットを追加することを確認してください。

Step 2: ファイル名を選ぶ

• 製品名またはテクノロジー名をもとに、短く小文字で、ハイフン区切りのスラッグを使用します。
• アルファベット順のカタログでカードが先頭に来る adk- などの接頭辞は避けてください。
• ファイルを docs/integrations/<slug>.md に作成します。

Step 3: ページの下書きを作成する

以下のフロントマターとカテゴリ別の骨組みを使用します。同じカテゴリの見本ページを読み、その文章やコードを参考に各セクションを記述してください。

render_catalog('integrations/*.md') によってページは自動検出されるため、mkdocs.yml にナビゲーション項目を追加しないでください。既存の URL を置き換えるページの場合に限り、リダイレクトを追加してください。また、リダイレクトを連鎖させないでください。

Step 4: 引き継ぐ

これは下書きであることをユーザーに伝え、次の点を案内してください。

• アイコンアセット（docs/integrations/assets/<slug>.png。正方形で適度なサイズ）と、スクリーンショットを追加するよう伝えます。
• 新しいページで integration-review スキルを実行するよう勧めます。
• カードが正しく表示され、アイコンが読み込まれることを確認するため、mkdocs serve の実行を勧めます。

フロントマター（全カテゴリ共通）

---
catalog_title: <Display Name>
catalog_description: <short verb-led phrase>
catalog_icon: /integrations/assets/<slug>.png
catalog_tags: ["<tag>", "<tag>"]
---

• catalog_description：簡潔で動詞から始まり、45～75 文字（約 6～11 語）を目安にします。カード上で不自然に折り返されないよう、約 80 文字以内にしてください。製品名を繰り返さないでください（タイトルに表示されます）。長いリストや誇張表現は避けてください。
• catalog_tags：カタログにすでに存在するタグのみを使用し、新しいタグを作らないでください。grep catalog_tags docs/integrations/*.md を一度実行して有効なタグを確認してください。タグは組み合わせて使用できます。MCP を使用するページには mcp を必ず含めてください。
• catalog_icon：/integrations/assets/<slug>.png（または .svg、.jpg）。/adk-docs/ の接頭辞は付けないでください。

H1 と言語サポートタグ（全カテゴリ共通）

# <Product> <type> for ADK

<type> には、カテゴリに応じて MCP tool、observability、または plugin を指定します。H1 の直後に言語サポート用の div を追加してください（span は 1 行にまとめます。Python のみの場合は TypeScript の span を削除します）。

<div class="language-support-tag">
  <span class="lst-supported">Supported in ADK</span><span class="lst-python">Python</span><span class="lst-typescript">TypeScript</span>
</div>

スケルトン：MCP ツール

## Use cases

- **<Use case>**: <what the user accomplishes>
- **<Use case>**: <...>

## Prerequisites

- <account, API key, or token, with a link to where to get it>

## Use with agent

=== "Python"

    === "Remote MCP Server"

        ```python
        from google.adk.agents import Agent
        from google.adk.tools.mcp_tool import McpToolset
        from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

        root_agent = Agent(
            model="gemini-flash-latest",
            name="<slug>_agent",
            instruction="Help users get information from <Product>",
            tools=[
                McpToolset(
                    connection_params=StreamableHTTPConnectionParams(
                        url="<server url>",
                        headers={"Authorization": "Bearer YOUR_TOKEN"},
                    ),
                )
            ],
        )
        ```

=== "TypeScript"

    === "Remote MCP Server"

        ```typescript
        import { LlmAgent, MCPToolset } from "@google/adk";

        const rootAgent = new LlmAgent({
            model: "gemini-flash-latest",
            name: "<slug>_agent",
            instruction: "Help users get information from <Product>",
            tools: [
                new MCPToolset({
                    type: "StreamableHTTPConnectionParams",
                    url: "<server url>",
                }),
            ],
        });

        export { rootAgent };
        ```

## Available tools

Tool | Description
---- | -----------
`<tool>` | <what it does>

## Additional resources

- [<Product> Documentation](<url>)
- [<Product> Repository](<url>)

サーバーが両方に対応している場合は、Local MCP Server（stdio）と Remote MCP Server の両方のサブタブを含めてください。任意のヘッダーまたは環境変数を設定する場合は、## Configuration セクションを追加してください。

スケルトン：オブザーバビリティ

<one-paragraph intro of what the platform provides for ADK>

## Overview

- **<Capability>**: <...>
- **<Capability>**: <...>

## Installation

```bash
pip install <package>
```

## Setup

<API keys, environment variables, and instrumentor initialization>

## Observe

<a complete, runnable ADK agent example that is traced end-to-end>

## Support and Resources

- [<Platform> Documentation](<url>)
- [<Platform> Repository](<url>)

コピーしてそのまま実行できる、エンドツーエンドのコードブロックを1つだけ用意する方法も適切です。Setup と Observe に分割するより望ましい場合もよくあります。

スケルトン：プラグイン

## Use cases

- **<Use case>**: <...>

## Prerequisites

- <account / API key with link>

## Installation

```bash
pip install <package>
```

## Use with agent

```python
from <package> import <Plugin>
from google.adk.agents import Agent

root_agent = Agent(
    model="gemini-flash-latest",
    name="<slug>_agent",
    instruction="<what the agent does>",
    tools=<plugin>.get_tools(),
)
```

## Available tools

Tool | Description
---- | -----------
`<tool>` | <what it does>

## Additional resources

- [<Product> Documentation](<url>)
- [<Product> on PyPI](<url>)
- [<Product> on GitHub](<url>)

該当する場合は、環境変数を設定する ## Configuration セクションを追加してください。

スタイルルール

• サンプルコードでは、特定のバージョン付きモデル文字列ではなく、gemini-flash-latest、gemini-pro-latest、またはその他の有効な *-latest エイリアスを使用してください。新しいモデルバージョンのリリース時に、特定のバージョン付き文字列を使うとメンテナンスの負担が増えるためです。
• インポート：from google.adk.agents import Agent。MCP では from google.adk.tools.mcp_tool import McpToolset を使用します。エージェント変数は、Python では root_agent、TypeScript では rootAgent とし、export { rootAgent }; を記述してください。
• エムダッシュや冗長なAI生成コンテンツは避けてください。**用語**: の箇条書きではコロンを使用し、それ以外の文章は文を分けてください。
• ADK に言及する場合は「ADK」を使用し、「Google ADK」や「The ADK」は使用しないでください。
• 文をインラインコードの語句で始めないでください。
• ADK ドキュメント内のリンクはサイト相対パスにしてください（例：/sessions/memory/）。外部リンクは有効なものにしてください。リンクを創作しないでください。
• コードサンプルが実際のAPIとライブラリのコードに準拠していることを確認してください。正規のソースリポジトリは docs/community/contributing-guide.md に記載されています。
• ドラフトを提示する前に、パッケージが PyPI/npm に存在することを確認してください。