> ## 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.

# मिनी ऐप स्टार्टर प्रॉम्प्ट

> रॉ HTTP, SDK या एजेंट रनटाइम से छोटे Phaseo ऐप बनाने के लिए कोडिंग एजेंट हेतु कॉपी किए जा सकने वाले प्रॉम्प्ट।

जब आप कोडिंग एजेंट को अस्पष्ट इंटीग्रेशन योजना के बजाय छोटा, काम करने वाला ऐप बनाने वाला ठोस प्रॉम्प्ट देना चाहें, तब इस पेज का उपयोग करें।

<Tip>
  इन प्रॉम्प्ट को परिणाम पर केंद्रित और कार्यान्वयन-विशिष्ट बनाया गया है, ताकि Cursor, Claude Code, Codex और ऐसे अन्य टूल में बेहतर काम करें।
</Tip>

## इन प्रॉम्प्ट का उपयोग कैसे करें

<Steps>
  <Step title="इंटीग्रेशन का तरीका चुनें">
    ऐसा प्रॉम्प्ट चुनें जो ऐप द्वारा Phaseo को कॉल करने के तरीके से मेल खाता हो:

    * रॉ HTTP
    * एक आधिकारिक SDK
    * Vercel AI SDK
    * Agent SDK
  </Step>

  <Step title="स्क्वायर ब्रैकेट वाले वेरिएबल बदलें">
    कोडिंग एजेंट में प्रॉम्प्ट पेस्ट करने से पहले `[ऐप का विचार]`, `[फ़्रेमवर्क]`, `[मॉडल]` और `[LANGUAGE]` जैसी वैल्यू भरें।
  </Step>

  <Step title="सिर्फ़ कोड नहीं, सत्यापन भी माँगें">
    प्रॉम्प्ट में सत्यापन वाली पंक्तियाँ रखें। इससे एजेंट को बताना होगा कि उसने वास्तव में क्या चलाया, क्या मान लिया और अभी क्या मैन्युअल सेटअप चाहिए।
  </Step>
</Steps>

## प्रॉम्प्ट पैक

<AccordionGroup>
  <Accordion title="रॉ HTTP मिनी ऐप" icon="globe">
    <Prompt description="SDK के बजाय Phaseo के साथ **रॉ HTTP** का उपयोग करने वाला छोटा ऐप बनाएँ।" icon="globe" actions={["copy", "cursor"]}>
      {`आप Phaseo Gateway के साथ प्रोडक्शन-शैली का छोटा डेमो ऐप बना रहे हैं।

            [ऐप का विचार] के लिए [फ़्रेमवर्क] मिनी ऐप बनाएँ।

            आवश्यकताएँ:
            - Phaseo SDK के बजाय रॉ HTTP अनुरोध उपयोग करें।
            - Phaseo endpoint [ENDPOINT] का उपयोग करें।
            - मॉडल [मॉडल] का उपयोग करें।
            - PHASEO_API_KEY नाम के environment variable से API key पढ़ें।
            - ऐप को जानबूझकर छोटा रखें: एक मुख्य पेज, एक सर्वर रूट या हैंडलर और न्यूनतम स्टाइलिंग।
            - उपयोगकर्ता इनपुट, अनुरोध सबमिशन की स्थिति, मॉडल आउटपुट और गेटवे त्रुटि की स्थिति दिखाएँ।
            - बाद में इंटीग्रेशन की जाँच आसान बनाने के लिए टिप्पणियों या दस्तावेज़ में एक अनुरोध पेलोड उदाहरण जोड़ें।

            कार्यान्वयन विवरण:
            - fetch का उपयोग करें।
            - फ़ील्ड को एब्स्ट्रैक्शन के पीछे छिपाने के बजाय अनुरोध बॉडी स्पष्ट रखें।
            - API अनुरोध करने से पहले खाली इनपुट के लिए बुनियादी वैलिडेशन जोड़ें।
            - non-200 प्रतिक्रियाएँ सही ढंग से संभालें और उपयोगी होने पर response body दिखाएँ।
            - सीक्रेट सिर्फ़ सर्वर पर रखें।

            डिलिवरेबल:
            - ऐप का कोड।
            - इसे चलाने का तरीका बताने वाला README का छोटा अनुभाग।
            - PHASEO_API_KEY के लिए .env.example एंट्री।

            सत्यापन:
            - संभव हो तो स्थानीय ऐप चलाएँ।
            - एक सफल अनुरोध पथ सत्यापित करें।
            - ठीक-ठीक बताएँ कि क्या सत्यापित किया, क्या नहीं कर सके और कौन सी धारणाएँ बाकी हैं।`}
    </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 का उपयोग करें।
            - मॉडल [मॉडल] का उपयोग करें।
            - किसी अन्य endpoint का उपयोग करने का ठोस कारण न हो, तो Responses API को प्राथमिकता दें।
            - PHASEO_API_KEY से API key पढ़ें।
            - पहले इंटीग्रेशन के लिए कोड छोटा और समझने योग्य रखें।
            - UI में लोडिंग, सफलता और विफलता की स्थितियाँ दिखाएँ।

            कार्यान्वयन विवरण:
            - SDK कॉल को कई फ़ाइलों में फैलाने के बजाय एक सर्वर-साइड इंटीग्रेशन सीमा रखें।
            - मॉडल, इनपुट और ज़रूरी विकल्पों सहित अनुरोध का आकार स्पष्ट रखें।
            - असिस्टेंट का अंतिम टेक्स्ट सुरक्षित रूप से निकालने वाला response parsing उदाहरण शामिल करें।
            - जहाँ SDK response shape अन्यथा अस्पष्ट हो, वहीं न्यूनतम टिप्पणियाँ जोड़ें।

            डिलिवरेबल:
            - काम करने वाला ऐप कोड।
            - सेटअप के संक्षिप्त निर्देश।
            - इस मिनी ऐप के लिए रॉ HTTP की तुलना में TypeScript SDK बेहतर क्यों है, इसकी संक्षिप्त व्याख्या।

            सत्यापन:
            - संभव हो तो ऐप चलाएँ।
            - एक अनुरोध को शुरू से अंत तक चलाएँ।
            - बदली गई फ़ाइलों और उपयोगकर्ता को बाकी सेटअप की सटीक जानकारी दें।`}
    </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 से क्रेडेंशियल पढ़ें।
            - कोड इतना छोटा रखें कि टीम का नया सदस्य उसे जल्दी समझ सके।
            - एक उपयोगकर्ता इनपुट पथ और एक मॉडल आउटपुट पथ शामिल करें।
            - अमान्य इनपुट और upstream gateway विफलताओं के लिए स्पष्ट त्रुटि प्रबंधन शामिल करें।

            कार्यान्वयन विवरण:
            - एक ऐसा इंटीग्रेशन मॉड्यूल रखें जो Phaseo client बनाने का काम संभाले।
            - अनावश्यक एब्स्ट्रैक्शन में लपेटने के बजाय SDK response shape सीधे उपयोग करें।
            - ऐप के लिए structured output उपयोगी हो, तो उसका उपयोग करें और लौटाए गए आकार को मान्य करें।
            - README में इंस्टॉल और चलाने के चरणों वाला छोटा अनुभाग जोड़ें।

            डिलिवरेबल:
            - ऐप कोड।
            - कोई भी dependency अपडेट।
            - उपयोग के संक्षिप्त निर्देश।

            सत्यापन:
            - संभव हो तो संबंधित कमांड चलाएँ।
            - एक सफल अनुरोध पथ सत्यापित करें या बताएँ कि ऐसा क्यों नहीं कर सके।
            - उपयोगकर्ता को जिन environment variables या स्थानीय सेवाओं की ज़रूरत है, उन्हें बताएँ।`}
    </Prompt>
  </Accordion>

  <Accordion title="Vercel AI SDK मिनी ऐप" icon="code">
    <Prompt description="**Vercel AI SDK के ज़रिए Phaseo** का उपयोग करने वाला छोटा ऐप बनाएँ।" icon="code" actions={["copy", "cursor"]}>
      {`आप Vercel AI SDK provider के ज़रिए Phaseo उपयोग करने वाला मिनी ऐप बना रहे हैं।

            [ऐप का विचार] के लिए [फ़्रेमवर्क] ऐप बनाएँ।

            आवश्यकताएँ:
            - Phaseo Vercel AI SDK provider का उपयोग करें।
            - मॉडल [मॉडल] का उपयोग करें।
            - PHASEO_API_KEY से Phaseo API key पढ़ें।
            - UX को हल्का रखें और उपयोगकर्ता के एक स्पष्ट कार्य पर केंद्रित करें।
            - ऐप चैट जैसा हो तो स्ट्रीमिंग आउटपुट सपोर्ट करें; अन्यथा बताएँ कि यहाँ नॉन-स्ट्रीमिंग सरल क्यों है।

            कार्यान्वयन विवरण:
            - प्रदाता वायरिंग स्पष्ट रखें।
            - AI SDK primitives का मानक और framework-अनुकूल ढंग से उपयोग करें।
            - पहले संस्करण में अनावश्यक अतिरिक्त state management से बचें।
            - प्रदाता मॉडल ID कैसे चुनी जाती है, इसकी संक्षिप्त व्याख्या जोड़ें।

            डिलिवरेबल:
            - ऐप कोड।
            - सेटअप के चरण।
            - बाद में किसी दूसरे मॉडल पर कैसे जाएँ, इस पर संक्षिप्त टिप्पणी।

            सत्यापन:
            - संभव हो तो ऐप चलाएँ।
            - मुख्य उपयोगकर्ता प्रवाह सत्यापित करें।
            - जिन हिस्सों का सत्यापन नहीं हुआ, उनकी अलग से जानकारी दें।`}
    </Prompt>
  </Accordion>

  <Accordion title="Agent SDK मिनी ऐप" icon="bot">
    <Prompt description="**Phaseo Agent SDK** और सीमित टूल लूप से छोटा ऐप बनाएँ।" icon="bot" actions={["copy", "cursor"]}>
      {`आप Phaseo Gateway पर छोटा agentic ऐप बना रहे हैं।

            Phaseo Agent SDK का उपयोग करके [ऐप का विचार] के लिए [LANGUAGE] मिनी ऐप बनाएँ।

            आवश्यकताएँ:
            - [LANGUAGE] के लिए Phaseo Agent SDK का उपयोग करें।
            - मॉडल [मॉडल] का उपयोग करें।
            - केवल एक या दो नियतात्मक स्थानीय टूल शामिल करें।
            - टूल लूप सीमित और डीबग करने में आसान रखें।
            - PHASEO_API_KEY से API key पढ़ें।
            - अंतिम आउटपुट दिखाएँ और जहाँ उचित हो, टूल गतिविधि या तर्क की मध्यवर्ती स्थिति भी दिखाएँ।

            कार्यान्वयन विवरण:
            - एजेंट की परिभाषा एक ही जगह रखें।
            - टूल परिभाषाएँ छोटी और नियतात्मक रखें।
            - पहले संस्करण के लिए बड़ा सामान्य-उद्देश्य एजेंट फ़्रेमवर्क न बनाएँ।
            - बाद में ऐप को फिर से शुरू करने योग्य बनाने पर रन स्थिति कहाँ सहेजी जाएगी, इसका नोट जोड़ें।

            डिलिवरेबल:
            - ऐप कोड।
            - सेटअप निर्देश।
            - इस वर्कफ़्लो में one-shot completion से Agent SDK बेहतर क्यों है, इसकी संक्षिप्त व्याख्या।

            सत्यापन:
            - संभव हो तो मुख्य पथ चलाएँ।
            - एक एजेंट रन को शुरू से अंत तक सत्यापित करें।
            - बाकी धारणाएँ बताएँ, खासकर पर्यावरण सेटअप या स्थानीय टूल निर्भरताओं के बारे में।`}
    </Prompt>
  </Accordion>
</AccordionGroup>

## प्रॉम्प्ट को बेहतर कैसे बनाएँ

* `[ऐप का विचार]` में व्यापक उत्पाद विवरण के बजाय उपयोगकर्ता का एक सीमित कार्य लिखें।
* `[मॉडल]` को एजेंट द्वारा उपयोग की जाने वाली सटीक मॉडल ID से बदलें।
* बताएँ कि आउटपुट मुक्त टेक्स्ट, सख्त JSON, चैट या एक जनरेटेड एसेट होना चाहिए।
* पता हो तो UI फ़्रेमवर्क और डिप्लॉयमेंट लक्ष्य बताएँ।
* एक या दो ज़रूरी पाबंदियाँ जोड़ें, जैसे `केवल EU प्रदाता`, `स्ट्रीमिंग उपयोग करें` या `सभी सीक्रेट सर्वर पर रखें`।

## संबंधित गाइड

* [क्विकस्टार्ट](../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.