Working With Cognipeer Console
The SDK is not a replacement for Cognipeer Console. It is the developer-facing client for applications that call a Console deployment.
Use Console For
- deployment and hosting,
- tenant isolation and access control,
- API token issuance,
- providers, models, vector stores, files, prompts, agents, and guardrails,
- tracing dashboards, incidents, and operational workflows.
See the Cognipeer Console docs for those topics.
Use The SDK For
- initializing a client in TypeScript or JavaScript,
- making authenticated calls from apps and services,
- using typed request and response models,
- integrating with frameworks and runtimes,
- replacing ad-hoc fetch calls with a stable client layer.
Typical Team Workflow
- A platform team deploys and configures Cognipeer Console.
- Providers, policies, and runtime features are configured in the dashboard.
- An API token is created for the consuming application.
- The application team installs
@cognipeer/console-sdk. - The SDK is pointed at the Console client API base URL.
- Application traffic is observed back in Console through tracing, alerts, and operational dashboards.
Base URL For Self-Hosted Console
When you connect to a self-hosted deployment, use the full client API base URL:
text
https://your-console.example.com/api/client/v1The SDK targets the Console client API surface, not the dashboard root.
Canonical Ownership
| Topic | Canonical docs |
|---|---|
| Deployment, providers, tenancy, platform behavior | Cognipeer Console docs |
| Raw endpoint semantics and HTTP payloads | Cognipeer Console API reference |
| TypeScript and JavaScript method signatures | Console SDK docs |
| Examples and framework integrations | Console SDK docs |