> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ミニアプリ用スタータープロンプト

> コーディングエージェントが raw HTTP、SDK、エージェントランタイムを使って小規模な Phaseo アプリを作るための、コピー可能なプロンプトです。

あいまいな統合計画ではなく、小さくても動作するアプリを作るための具体的なプロンプトをコーディングエージェントに渡す場合に、このページを使います。

<Tip>
  Cursor、Claude Code、Codex などで効果的に使えるよう、これらのプロンプトは成果と実装方法を具体的に指定しています。
</Tip>

## プロンプトの使い方

<Steps>
  <Step title="統合方法を選ぶ">
    アプリから Phaseo を呼び出す方法に合ったプロンプトを選びます。

    * raw HTTP
    * 公式 SDK
    * Vercel AI SDK
    * Agent SDK
  </Step>

  <Step title="角括弧の変数を置き換える">
    コーディングエージェントに貼り付ける前に、`[アプリのアイデア]`、`[フレームワーク]`、`[モデル]`、`[LANGUAGE]` などの値を入力します。
  </Step>

  <Step title="コードだけでなく検証も求める">
    プロンプトには検証項目を残してください。エージェントが実際に実行した内容、置いた前提、手動設定が必要な項目を報告するようになります。
  </Step>
</Steps>

## プロンプト集

<AccordionGroup>
  <Accordion title="raw HTTP ミニアプリ" icon="globe">
    <Prompt description="SDK ではなく、Phaseo に **raw HTTP** でアクセスする小さなアプリを作成します。" icon="globe" actions={["copy", "cursor"]}>
      {`Phaseo Gateway を使った、小規模で本番品質を意識したデモアプリを実装してください。

            [アプリのアイデア] 向けの [フレームワーク] ミニアプリを作成してください。

            要件:
            - Phaseo SDK ではなく、raw HTTP リクエストを使ってください。
            - Phaseo のエンドポイント [ENDPOINT] を使ってください。
            - モデル [モデル] を使ってください。
            - PHASEO_API_KEY という環境変数から API キーを読み取ってください。
            - 意図的に小さなアプリにします。メインページ 1 つ、サーバールートまたはハンドラー 1 つ、最小限のスタイルだけにしてください。
            - ユーザー入力、リクエスト送信状態、モデル出力、ゲートウェイのエラー状態を表示してください。
            - 後から統合内容を簡単に監査できるよう、コメントまたはドキュメントにリクエストペイロードの例を 1 つ追加してください。

            実装の詳細:
            - fetch を使ってください。
            - フィールドを抽象化の背後に隠さず、リクエストボディを明示してください。
            - API リクエストを送信する前に、入力が空でないか基本的な検証を追加してください。
            - 200 以外のレスポンスを適切に処理し、有用な場合はレスポンスボディを表示してください。
            - シークレットはサーバー側だけで扱ってください。

            成果物:
            - アプリのコード。
            - 実行方法を説明する README の短いセクション。
            - PHASEO_API_KEY 用の .env.example エントリ。

            検証:
            - 可能であればローカルでアプリを実行してください。
            - リクエストが成功する経路を 1 つ検証してください。
            - 実際に検証した内容、検証できなかった内容、残る前提を正確に報告してください。`}
    </Prompt>
  </Accordion>

  <Accordion title="TypeScript SDK ミニアプリ" icon="file-code-2">
    <Prompt description="**TypeScript SDK** を使って、簡潔で確認しやすい統合を備えたミニアプリを作成します。" icon="file-code-2" actions={["copy", "cursor"]}>
      {`Phaseo TypeScript SDK を使って小さなアプリを作成してください。

            [アプリのアイデア] 向けの [フレームワーク] ミニアプリを作成してください。

            要件:
            - @phaseo/sdk を使ってください。
            - モデル [モデル] を使ってください。
            - 別のエンドポイントを使う明確な理由がない限り、Responses API を優先してください。
            - PHASEO_API_KEY から API キーを読み取ってください。
            - 初回の統合でも理解しやすい、簡潔なコードにしてください。
            - UI に読み込み中、成功、失敗の状態を表示してください。

            実装の詳細:
            - SDK 呼び出しを複数のファイルに分散させず、サーバー側の統合境界を 1 か所に設けてください。
            - モデル、入力、重要なオプションを含め、リクエストの形を明示してください。
            - 最終的なアシスタントテキストを安全に取り出すレスポンス解析例を 1 つ追加してください。
            - SDK のレスポンス構造が分かりにくい箇所にだけ、最小限のコメントを追加してください。

            成果物:
            - 動作するアプリコード。
            - 簡潔なセットアップ手順。
            - このミニアプリでは raw HTTP より TypeScript SDK が適している理由を簡潔に説明してください。

            検証:
            - 可能であればアプリを実行してください。
            - エンドツーエンドのリクエストを 1 つ実行してください。
            - 変更したファイルと、ユーザー側に残るセットアップ作業を正確に報告してください。`}
    </Prompt>
  </Accordion>

  <Accordion title="Python SDK ミニアプリ" icon="snake">
    <Prompt description="**公式 Python SDK** を使った小さな Python アプリまたはサービスを作成します。" icon="snake" actions={["copy", "cursor"]}>
      {`Phaseo Gateway を使った小規模な AI 搭載 Python アプリを実装してください。

            [アプリのアイデア] 向けの [Python のフレームワークまたはアプリの種類] アプリを作成してください。

            要件:
            - 公式 Python SDK の phaseo を使ってください。
            - モデル [モデル] を使ってください。
            - PHASEO_API_KEY から認証情報を読み取ってください。
            - 新しいチームメンバーがすぐに理解できるよう、コードを小さく保ってください。
            - ユーザー入力の経路とモデル出力の経路を 1 つずつ用意してください。
            - 無効な入力や上流ゲートウェイの失敗を適切に処理してください。

            実装の詳細:
            - Phaseo クライアントの作成を担う統合モジュールを 1 つにまとめてください。
            - 不要な抽象化でSDKのレスポンス形式を包まず、そのまま使用してください。
            - 構造化出力がアプリに役立つ場合は使用し、返された形式を検証してください。
            - README にインストールと実行手順を簡潔に記載してください。

            成果物:
            - アプリコード。
            - 依存関係の更新。
            - 簡潔な使用手順。

            検証:
            - 可能であれば関連するコマンドを実行してください。
            - リクエストが成功する経路を 1 つ検証するか、できなかった理由を説明してください。
            - ユーザー側で追加設定が必要な環境変数やローカルサービスを明記してください。`}
    </Prompt>
  </Accordion>

  <Accordion title="Vercel AI SDK ミニアプリ" icon="code">
    <Prompt description="**Vercel AI SDK を通じて Phaseo を使う**小さなアプリを作成します。" icon="code" actions={["copy", "cursor"]}>
      {`Vercel AI SDK のプロバイダーを通じて Phaseo を使うミニアプリを作成してください。

            [アプリのアイデア] 向けの [フレームワーク] アプリを作成してください。

            要件:
            - Phaseo の Vercel AI SDK プロバイダーを使ってください。
            - モデル [モデル] を使ってください。
            - PHASEO_API_KEY から Phaseo API キーを読み取ってください。
            - UX は軽量にし、ユーザーの明確なタスク 1 つに集中させてください。
            - チャット形式のアプリならストリーミング出力に対応し、そうでなければ非ストリーミングの方が簡潔な理由を説明してください。

            実装の詳細:
            - プロバイダーの接続設定を明示してください。
            - AI SDK のプリミティブを標準的かつフレームワークに適した方法で使ってください。
            - 初版では不要な状態管理を増やさないでください。
            - プロバイダーのモデル ID の選び方を簡潔に説明してください。

            成果物:
            - アプリコード。
            - セットアップ手順。
            - 後から別のモデルに切り替える方法を簡潔に説明してください。

            検証:
            - 可能であればアプリを実行してください。
            - メインのユーザーフローを検証してください。
            - 未検証の部分は分けて報告してください。`}
    </Prompt>
  </Accordion>

  <Accordion title="Agent SDK ミニアプリ" icon="bot">
    <Prompt description="**Phaseo Agent SDK** と範囲を限定したツールループを使って、小さなアプリを作成します。" icon="bot" actions={["copy", "cursor"]}>
      {`Phaseo Gateway 上に小規模なエージェントアプリを作成してください。

            Phaseo Agent SDK を使い、[アプリのアイデア] 向けの [LANGUAGE] ミニアプリを作成してください。

            要件:
            - [LANGUAGE] 用の Phaseo Agent SDK を使ってください。
            - モデル [モデル] を使ってください。
            - 決定論的なローカルツールを 1～2 個だけ含めてください。
            - ツールループの上限を設け、デバッグしやすくしてください。
            - PHASEO_API_KEY から API キーを読み取ってください。
            - 最終出力と、必要に応じてツールの動作や推論の中間状態を表示してください。

            実装の詳細:
            - エージェント定義は 1 か所にまとめてください。
            - ツール定義は小さく、決定論的にしてください。
            - 初版では巨大で汎用的なエージェントフレームワークを避けてください。
            - 後から再開可能なアプリにする場合、実行状態をどこに永続化するか説明を追加してください。

            成果物:
            - アプリコード。
            - セットアップ手順。
            - このワークフローで 1 回きりの completion より Agent SDK が適している理由を簡潔に説明してください。

            検証:
            - 可能であればメインの経路を実行してください。
            - エージェントの実行を 1 回エンドツーエンドで検証してください。
            - 環境設定やローカルツールの依存関係に関するものを含め、残る前提を報告してください。`}
    </Prompt>
  </Accordion>
</AccordionGroup>

## プロンプトをより効果的にする方法

* `[アプリのアイデア]` には広い製品構想ではなく、具体的で限定されたユーザーの作業を指定してください。
* エージェントに使わせたいモデルの正確な ID を `[モデル]` に指定してください。
* 出力を自由形式テキスト、厳密な JSON、チャット、または単一の生成アセットのどれにするか指定してください。
* 分かる場合は、UI フレームワークとデプロイ先を記載してください。
* `EU-only providers`、`use streaming`、`keep all secrets server-side` のような重要な制約を 1～2 個追加してください。

## 関連ガイド

* [クイックスタート](../quickstart.mdx)
* [例](../guides/examples.mdx)
* [TypeScript SDK の概要](../sdk-reference/typescript/overview.mdx)
* [Python SDK の概要](../sdk-reference/python/overview.mdx)
* [Agent SDK の概要](../sdk-reference/agent-sdk/overview.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.