· SDKv0.4.0Bring AI agents
into your products.
The Inceptiva SDK lets you connect intelligent agents to your backend, use their knowledge, and start conversations in seconds.
◇ Easy to use◇ Fully typed◇ SSE streaming◇ Public API
import { Inceptiva } from '@inceptiva/sdk';
const client = new Inceptiva({
apiKey: process.env.INCEPTIVA_API_KEY,
agentId: 'AGENT_ID'
});
const result = await client.invoke({
message: 'Analiza esta oportunidad comercial'
});
console.log(result.response);
console.log(result.conversationId);Get started in 5 minutes
Everything you need to integrate your first agent.
011. Install the SDK
Install it with npm, pip, or NuGet.
022. Get your API keyCreate an API channel and obtain your key.
033. Create an agentDefine its purpose and behavior.
044. Add knowledgeUpload documents or connect a source.
055. Invoke and chatSend messages and receive responses.
066. ShipIntegrate the agent into your product.
Popular guides
Essential concepts for integrating Inceptiva.
◇BasicsCreate your first agent
Publish an API channel and configure credentials.
◇ConceptConversationsKeep context and retrieve message history.
◇SecurityAuthenticationProtect and rotate your API keys correctly.
◇ReferenceError handlingHandle HTTP statuses and usage limits.
◇SDKSSE streamingDisplay responses while they are generated.
Ready-to-run examples
Executable projects for every official SDK.
How does Inceptiva work?
Architecture and request flow.
request.createdoutput_text.deltaresponse.completed
Quick reference
AgentsGETPOST
ConversationsGETPOST
MetadataGETPOST
ErrorsGETPOST
API Reference →Available SDKs
TypeScript / Node.jsv0.4.0
Pythonv0.4.0
.NETv0.4.0What's new
v0.4.0 · 3 Aug 2026
Idempotency, external references, paginated history, and limit metadata.
API Playground
Run a request against the API configured for this environment.
Credentials are never stored
import { randomUUID } from "node:crypto";
import { Inceptiva, collectStream } from "@inceptiva/sdk";
const client = new Inceptiva({
apiKey: process.env.INCEPTIVA_API_KEY!,
agentId: "AGENT_ID",
baseUrl: "https://api.inceptiva.com",
});
const result = await collectStream(client.responses.stream({
message: "Analyze this opportunity",
idempotencyKey: randomUUID(),
}));
console.log(result.response);