> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK Guides

> Step-by-step instructions for common SDK tasks

These guides help you accomplish specific tasks using the Narrative TypeScript SDK. They assume basic familiarity with the SDK and focus on practical implementation.

<Info>
  New to the SDK? Start with the [SDK Quickstart](/getting-started/sdk-quickstart) tutorial to install and configure the SDK.
</Info>

## Getting started

<CardGroup cols={2}>
  <Card title="SDK Quickstart" icon="rocket" href="/getting-started/sdk-quickstart">
    Install the SDK and run your first query
  </Card>

  <Card title="Authentication" icon="key" href="/guides/sdk/authentication">
    Configure API key authentication
  </Card>
</CardGroup>

## Data operations

<CardGroup cols={2}>
  <Card title="Executing Queries" icon="terminal" href="/guides/sdk/executing-queries">
    Run, validate, and compile NQL queries
  </Card>

  <Card title="Managing Datasets" icon="database" href="/guides/sdk/managing-datasets">
    Create, read, update, and delete datasets
  </Card>

  <Card title="Uploading Data" icon="upload" href="/guides/sdk/uploading-data">
    Upload files to datasets
  </Card>
</CardGroup>

## Model Inference

<CardGroup cols={2}>
  <Card title="Running Model Inference" icon="brain" href="/guides/sdk/running-model-inference">
    Submit inference requests to hosted LLMs
  </Card>

  <Card title="Using Structured Output" icon="brackets-curly" href="/guides/sdk/structured-inference-output">
    Define JSON Schema for typed responses
  </Card>

  <Card title="Choosing Models" icon="scale-balanced" href="/guides/sdk/choosing-inference-models">
    Select the right model for your task
  </Card>
</CardGroup>

## Monitoring and reliability

<CardGroup cols={2}>
  <Card title="Tracking Jobs" icon="spinner" href="/guides/sdk/tracking-jobs">
    Monitor asynchronous job status
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/guides/sdk/error-handling">
    Handle errors gracefully
  </Card>
</CardGroup>

## Reference

<CardGroup cols={2}>
  <Card title="SDK Reference" icon="book" href="/reference/sdks/typescript">
    TypeScript SDK overview and architecture
  </Card>

  <Card title="Configuration" icon="gear" href="/reference/sdks/typescript/configuration">
    Complete configuration options
  </Card>

  <Card title="API Modules" icon="puzzle-piece" href="/reference/sdks/typescript/api-modules">
    All available methods and parameters
  </Card>

  <Card title="REST API" icon="code" href="/api-reference">
    Full REST API documentation
  </Card>
</CardGroup>

## Recipes

<CardGroup cols={2}>
  <Card title="Automating Data Workflows" icon="robot" href="/cookbooks/sdk/typescript-automation">
    Build a complete automation pipeline
  </Card>
</CardGroup>