Felo API PlatformFelo API Platform

ریسرچ

ایک سوال کو ذرائع والے ریسرچ بریف میں بدلیں

ویب سے پوچھیں، جواب کے پیچھے کے صفحات Markdown میں محفوظ کریں، X پر ماہرین کیا کہتے ہیں شامل کریں اور ثبوت ایسے LiveDoc میں رکھیں جسے بعد میں دوبارہ تلاش کیا جا سکے۔

وقت20 منٹسطحدرمیانہاپ ڈیٹ2026-10-29
کिसके لیےبانیان اور آپریٹرزمارکیٹ محققینGTM ٹیمیں

پرامپٹ کاپی کریں

مربع بریکٹ کے فیلڈز بدلیں اور Claude Code، Codex یا ٹرمینل رسائی والے AI میں چسپاں کریں۔ یہ Felo اسکل نصب کرتا ہے، کریڈٹ سے پہلے پوچھتا ہے اور ورک فلو چلاتا ہے۔

[سوال یا فیصلے] کے لیے ذرائع والا تحقیقی بریف تیار کریں۔

دائرہ: [مارکیٹ، علاقہ، زبان]۔ مدت: [گزشتہ 30 دن / گزشتہ 12 ماہ]۔ قارئین: [کون پڑھے گا]۔ گہرائی: [ایک صفحے کا جائزہ / مکمل بریف]۔

Markdown بریف میں شامل ہوں:
1. تین نکات میں مختصر جواب۔
2. ثبوت جدول: دعویٰ، ماخذ کا عنوان، URL، اشاعت کی تاریخ۔
3. وہ نکات جن پر ذرائع متفق نہیں۔
4. جو اب بھی نامعلوم ہے۔
5. ذرائع کی مکمل فہرست۔

قواعد:
- ہر حقیقی دعوے کے ساتھ ماخذ لنک ہو۔ حقائق، رائے اور اپنے اندازے الگ رکھیں۔
- کبھی حوالے، اعداد، تاریخیں یا ذرائع گھڑ کر نہ لکھیں۔ ڈیٹا نہ ہو تو «ڈیٹا دستیاب نہیں» لکھیں، صفر نہیں۔
- بنیادی ذرائع کو ترجیح دیں۔ X کو ماہرین کے اشارے کے طور پر استعمال کریں، ثبوت کے طور پر نہیں۔
- مدت کو واضح آغاز اور اختتام کی تاریخوں میں بدلیں اور ٹائم زون لکھیں۔
- کریڈٹ خرچ کرنے سے پہلے منصوبہ بند API کالز دکھائیں اور میری منظوری کا انتظار کریں۔
- بار بار چلنے والا کام نہ بنائیں، پیغام نہ بھیجیں اور کچھ شائع نہ کریں۔
- نتیجہ ./research-brief.md میں لکھیں اور چیٹ میں خلاصہ دیں۔

کاپی میں تنصیب کے مراحل اور حفاظتی اصول بھی شامل ہیں۔

آپ کو کیا ملتا ہے

ایک رن کی مثال آؤٹ پٹ۔ لائیو جنریشن نہیں۔

نمونہ بریف (اقتباس)

کیا چھوٹے ماڈل سپورٹ بوٹس میں بڑے ماڈل کی جگہ لیں گے؟

مختصر جواب

  • چھوٹے ماڈل درجہ بندی اور پہلی صف کے جوابات کے لیے کافی ہیں۔
  • رکاوٹ ماڈل کے سائز کی نہیں، بازیابی کے معیار کی ہے۔
  • تبدیل ہونے والی ٹیمیں فی ٹکٹ کم لاگت بتاتی ہیں، زیادہ حل کی شرح نہیں۔
دعویٰذریعہتاریخ
بازیابی کا معیار جواب کا معیار طے کرتا ہےhttps://example.com/rag-eval2026-10-12
فی حل شدہ ٹکٹ لاگت 38% کم ہوئیhttps://example.com/support-case2026-09-28

جہاں ذرائع متفق نہیں

وینڈر بینچ مارک تقریباً برابر ہیں؛ آزاد ٹیسٹ کئی مرحلوں والی واپسی میں فرق دیکھتے ہیں۔

جو اب بھی نامعلوم ہے

فرق بہتر ٹولز سے ختم ہوگا یا بڑا ماڈل درکار ہے۔

درست کالز

ڈویلپرز کے لیے: وہی ورک فلو کوڈ کے طور پر، چلانے کی ترتیب میں۔

اصل API کالز دکھائیں
  1. ویب سے پوچھیں

    Chat ویب تلاش کرتا ہے، ذرائع ترتیب دیتا ہے، جواب لکھتا ہے اور استعمال شدہ وسائل واپس کرتا ہے۔ پہلے تین رکھیں: ہر اگلا مرحلہ ان لنکس میں سے ایک کی پیروی کرتا ہے۔ ہیلپر کلید ایک بار بھیجتا ہے اور 2xx سے باہر خرابی دیتا ہے۔

    research.ts
    const BASE = "https://openapi.felo.ai";
    const headers = {
      Authorization: `Bearer ${process.env.FELO_API_KEY}`,
      "Content-Type": "application/json",
    };
    
    async function felo<T>(path: string, body?: unknown): Promise<T> {
      const res = await fetch(`${BASE}${path}`, {
        method: body ? "POST" : "GET",
        headers,
        body: body ? JSON.stringify(body) : undefined,
      });
      if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
      return res.json() as Promise<T>;
    }
    
    type ChatData = {
      data: { answer: string; resources: { link: string; title: string }[] };
    };
    
    export async function answer(question: string) {
      const chat = await felo<ChatData>("/v2/chat", { query: question });
      return { answer: chat.data.answer, sources: chat.data.resources.slice(0, 3) };
    }

    مثال آؤٹ پٹ

    {
      "answer": "Recent developments include …",
      "sources": [
        { "link": "https://example.com/article", "title": "…" }
      ]
    }
  2. جواب کے پیچھے کے صفحات ڈاؤن لوڈ کریں

    بریف کے لیے اقتباس کافی نہیں۔ صفحات کو پڑھنے کے موڈ کے ساتھ Markdown میں ڈاؤن لوڈ کریں تاکہ حوالے اور سرخیاں نیویگیشن کے شور کے بغیر رہیں۔ وہی URL دوبارہ مانگنے پر ایکسٹریکشن کیشے پر جا سکتا ہے۔

    research.ts
    type ExtractData = { data: { content: string } };
    
    const pages = await Promise.all(
      sources.map((source) =>
        felo<ExtractData>("/v2/web/extract", {
          url: source.link,
          output_format: "markdown",
          with_readability: true,
          with_cache: true,
        }).then((page) => ({ ...source, content: page.data.content })),
      ),
    );

    مثال آؤٹ پٹ

    // pages[0].content
    "# Example Article\n\nExtracted article content…"
  3. X کیا کہتا ہے شامل کریں

    خبریں اعلانات کور کرتی ہیں؛ X دکھاتا ہے لوگ عملی طور پر کس چیز سے گزرتے ہیں۔ آخری سات دن تلاش کریں اور مصنف اور وقت رکھیں تاکہ بریف ہر دعوے کی نسبت دے سکے۔ دائرہ بڑھانے کے لیے limit بڑھائیں؛ ہر نتائج صفحے میں cursor ہے۔

    research.ts
    type XData = {
      data: {
        tweets: {
          content: string;
          author: { username: string };
          created_at: string;
        }[];
      };
    };
    
    const since = Math.floor((Date.now() - 7 * 24 * 60 * 60 * 1000) / 1000);
    
    const social = await felo<XData>("/v2/x/tweet/search", {
      query: question,
      limit: 10,
      since_time: since,
    });

    مثال آؤٹ پٹ

    { "data": { "tweets": [
      { "content": "…", "author": { "username": "…" }, "created_at": "…" }
    ] } }
  4. ثبوت LiveDoc میں محفوظ کریں

    LiveDoc بنائیں اور ذرائع کو URL وسائل کے طور پر شامل کریں۔ API دیکھے گئے URL ڈپلیکیٹ ہٹاتا ہے اور فی URL resource id واپس کرتا ہے، اس لیے اگلے سوالات وہی ثبوت دوبارہ ڈاؤن لوڈ کیے بغیر تلاش کر سکتے ہیں۔

    research.ts
    type LiveDocData = { data: { short_id: string } };
    
    const doc = await felo<LiveDocData>("/v2/livedocs", {
      name: `Research: ${question.slice(0, 60)}`,
      description: "Sources collected while answering the question",
    });
    
    await felo(`/v2/livedocs/${doc.data.short_id}/resources/urls`, {
      urls: sources.map((source) => ({ url: source.link, title: source.title })),
    });
    
    console.log(doc.data.short_id); // keep this for later queries
  5. بعد میں ثبوت سے دوبارہ پوچھیں

    فائدہ یہی ہے: اگلا سوال کھلی ویب کے بجائے LiveDoc پر سیمنٹک تلاش کرتا ہے۔ resource_ids صرف معلوم ذیلی مجموعے تک محدود کرنے کے لیے دیں۔

    research.ts
    type Retrieved = {
      data: { title: string; content: string; score: number }[];
    };
    
    async function ask(livedoc: string, query: string) {
      const hits = await felo<Retrieved>(
        `/v2/livedocs/${livedoc}/resources/retrieve`,
        { query },
      );
      return hits.data.filter((hit) => hit.score >= 0.7);
    }

    مثال آؤٹ پٹ

    [
      { "title": "…", "content": "…", "score": 0.92 }
    ]

کیا شامل ہے

  • Chat API سے ذرائع والا جواب اور پیچھے کے صفحات
  • مضبوط ترین ذرائع کے مکمل صفحات Markdown میں
  • مصنف اور تاریخ والی X پوسٹس ماہرین کے اشارے کے طور پر
  • LiveDoc جو ثبوت اگلے سوالات کے لیے تلاش کے قابل رکھتا ہے

کیا نہیں کرتا

  • صرف عوامی ذرائع؛ ادائیگی یا لاگ ان والے صفحات ناکام ہو سکتے ہیں
  • X کوریج اشارہ ہے، نمائندہ سروے نہیں
  • انٹرویو، نجی ڈیٹا یا ادائیگی ڈیٹابیس نہیں
  • ثبوت کم ہوں تو بریف خلا بھرنے کے بجائے یہ بتاتا ہے
  • ایک پرامپٹ پر ایک رن؛ شیڈولنگ آپ کے ایجنٹ یا cron میں

سوالات

ذرائع کہاں سے آتے ہیں؟

Chat API استعمال شدہ صفحات واپس کرتا ہے، Web Fetch مضبوط ترین کو Markdown بناتا ہے اور X Search تاریخ والی ماہر پوسٹس شامل کرتا ہے۔ ہر آئٹم اپنا URL رکھتا ہے۔

کیا ٹیکنالوجی سے باہر مارکیٹ پر تحقیق ہو سکتی ہے؟

ہاں۔ دائرہ فیلڈ کو اپنی مارکیٹ سے بدلیں۔ خاص مارکیٹوں میں عوامی ذرائع کم ہو سکتے ہیں؛ بریف اندازے کے بجائے ان خلاوں کو نشان زد کرتا ہے۔

کیا ثبوت رن کے بعد رہتے ہیں؟

ہاں اگر LiveDoc مرحلہ چلے۔ واپس شدہ short_id اگلے سوالات کو وہی صفحات دوبارہ ڈاؤن لوڈ کیے بغیر تلاش کرنے دیتا ہے۔

ایک بریف کی لاگت کتنی ہے؟

استعمال کے مطابق کریڈٹ میں بل؛ موجودہ نرخ قیمت صفحے پر۔ پرامپٹ خرچ سے پہلے منظوری مانگتا ہے۔

کیا ہر ہفتے چلایا جا سکتا ہے؟

ہاں لیکن یہ پرامپٹ ایک بار چلتا ہے۔ شیڈولنگ اس ایجنٹ یا cron میں رکھیں جو وہی ورک فلو چلائے۔

اگر ذریعہ پے وال کے پیچھے ہو؟

اسے چھوڑ دیا جاتا ہے اور دستیاب نہ ہونے کا نشان لگتا ہے۔ بریف کبھی گھڑی ہوئی حقیقت یا حوالے سے خلا نہیں بھرتا۔

متعلقہ ورک فلو

اسے اپنا بنائیں

وہی ترکیب، آپ کے اصل انداز کے مطابق۔

بریف فائل میں لکھیں

جواب، صفحہ اقتباسات اور X حوالے Markdown میں جوڑ کر رپورٹنگ ٹول کو دیں یا docs ریپو میں commit کریں۔ ذریعہ لنکس دعووں کے قریب رکھیں — بریف اپنے حوالوں کے برابر قیمتی ہے۔

شیڈول پر چلائیں

`answer()` کو cron میں لپیٹیں اور ہر بریف تاریخ والی فائل میں لکھیں۔ وہی LiveDoc ذرائع جمع کرتا ہے، چوتھا ہفتہ پہلے تین کے ثبوت سے جواب دیتا ہے۔

LiveDoc چھوڑ دیں

اگر پہلے سے ڈیٹابیس ہے وہاں چیٹ جواب اور نکالے گئے صفحات رکھیں۔ LiveDoc مرحلہ تلاش کے لیے ہے، ڈیفالٹ اسٹوریج کے لیے نہیں۔

اس ترکیب کے پیچھے کے ریفرنس صفحات اور اگلے مراحل۔