{"uid":"cap_WG3pFwkLrjPJiCDGornQr","slug":"ephemeral-rag-store-b6596cc9","name":"Ephemeral RAG Store","description":"Stores at most 20 short documents in an isolated SQLite row, embeds them with the local nomic-embed-text model, and performs cosine-similarity retrieval. Each store has a random identifier and a fixed 24-hour lifetime that is never extended by reads or writes. An in-process sweeper deletes expired rows every minute and each request also purges expiry. Input text is not written to request logs. This is retrieval infrastructure, not a durable database or an answer-generating model.","url":"https://agent.halowerk.com/v1/ephemeral-rag?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","maxLength":5000,"minLength":1},"top_k":{"type":"integer","default":5,"maximum":10,"minimum":1},"action":{"enum":["create","upsert","query","status","delete"],"type":"string"},"store_id":{"type":"string","maxLength":80,"minLength":30},"documents":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","maxLength":100,"minLength":1},"text":{"type":"string","maxLength":5000,"minLength":1},"metadata":{"type":"object","maxProperties":20,"additionalProperties":{"type":["string","number","boolean","null"]}}},"additionalProperties":false},"maxItems":20,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5E0_BvlJD3yz_iS8Gnz7z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a temporary, isolated vector store (max 20 documents, 24-hour TTL) with local embedding and cosine-similarity retrieval via nomic-embed-text","exampleAgentPrompt":"Create a new ephemeral store, add these 5 documents to it, and then query it with 'what are the refund policies?' and return the top 3 most relevant results.","exampleUseCases":[{"title":"Temporary context store for multi-turn agent","prompt":"I need you to create an ephemeral store, load these 15 support articles into it, and then for each user question in this session retrieve the top 5 relevant chunks — the store only needs to last until this conversation is done."},{"title":"One-time document search over uploaded files","prompt":"Take these 8 documents I just uploaded, store them in a temporary vector store with a 24-hour lifetime, and search them for anything related to 'data retention compliance' — give me the top 3 matches."},{"title":"Disposable RAG pipeline for sensitive content","prompt":"I have some confidential text snippets I need to search semantically — create a short-lived store that won't persist in logs, add the 12 snippets, query it for 'authorization procedures', and delete the store when you're done."}],"resultDescription":"Returns the store_id on creation, matched document chunks with cosine similarity scores on query, document counts and expiry timestamp on status, and confirmation on delete or upsert operations. No answer generation — raw retrieved passages only.","failureModes":["store_id not found or already expired (TTL elapsed after 24 hours)","document limit exceeded (more than 20 documents submitted)","text too long (document or query exceeds 5000 characters)","invalid action enum value","store_id missing or malformed on non-create actions","embedding model unavailable or overloaded","payment not completed (x402 payment required before processing)"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, privacy-conscious, short-lived semantic search layer for a small document set (up to 20 docs) that does not need to outlive a single session or task. Ideal for agentic pipelines that must avoid persisting sensitive text in logs or a durable database. Prefer over full vector databases when setup overhead, cost, and longevity are not warranted. Not appropriate when you need persistence beyond 24 hours, more than 20 documents, answer generation, or a durable knowledge base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:48:55.570Z","isFirstParty":false,"canonicalSlug":"ephemeral-rag-store-b6596cc9"}