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

# Custom Knowledge

> Teach Annie about your specific infrastructure, patterns, and team conventions using a three-tier knowledge system.

## Overview

Annie automatically learns from your connected integrations (AWS, Terraform, Datadog, etc.), but some knowledge isn't available in those systems — team conventions, business context, runbook locations, on-call contacts, and tribal knowledge.

**Custom Knowledge** lets you add this context so Annie can provide more accurate and relevant responses. It works in three tiers, depending on the size and nature of the information.

## Three Tiers of Knowledge

<CardGroup cols={3}>
  <Card title="Knowledge Entries" icon="book-open">
    Short pointers and guidelines injected directly into Annie's context. Best for concise rules, team conventions, and quick references.

    **20,000 character limit** across all entries.
  </Card>

  <Card title="Knowledge Dumps" icon="database">
    Larger structured data that Annie can query on demand. Not injected into context — written to Annie's working directory at the start of each conversation.

    CSV with headers and JSON are the recommended formats. **Up to 20 dumps per project.**
  </Card>

  <Card title="Knowledge Platforms" icon="globe">
    For full documentation libraries, connect Annie to your knowledge platform. Annie searches these on demand during investigations.

    Examples: [Jira](/pages/integration/jira), [Confluence](/pages/integration/confluence), [Guru](/pages/integration/guru).
  </Card>
</CardGroup>

## Knowledge Entries

Knowledge entries are injected directly into Annie's context at the start of every conversation. Because they consume context space, they should be kept concise — think pointers and guidelines rather than full documents.

**Best for:**

* Team conventions and naming standards
* Key contacts and escalation paths
* Quick reference rules (e.g., "always check Redis before the database")
* Links to important dashboards or runbooks

### Examples

<AccordionGroup>
  <Accordion icon="sitemap" title="Service Ownership">
    ```markdown theme={null}
    # Service Ownership
    - Payment service: @payments-team, escalate to payments-oncall@company.com
    - Auth service: @platform-team, security issues go to security@company.com
    - API Gateway: @infra-team
    ```
  </Accordion>

  <Accordion icon="wrench" title="Debugging Conventions">
    ```markdown theme={null}
    # Debugging Conventions
    - Always check Datadog dashboard "Service Overview" first
    - For database issues: check pg_stat_statements before scaling
    - Redis issues: check eviction rate, not just memory usage
    - Stripe timeouts: check Stripe status page before investigating internally
    ```
  </Accordion>

  <Accordion icon="list-check" title="Incident Severity Levels">
    ```markdown theme={null}
    # Incident Severity
    - SEV1: Customer-facing outage, all hands. Escalate to VP after 1 hour.
    - SEV2: Degraded service, on-call + team lead. Postmortem within 48h.
    - SEV3: Minor issue, on-call only.
    - Comms channel: #incidents (Slack), war room auto-created as #incident-{id}
    ```
  </Accordion>
</AccordionGroup>

## Knowledge Dumps

Knowledge dumps are for larger structured data that Annie can read on demand. They are **not** injected into Annie's context — instead, they are written as files to Annie's working directory. Annie's context includes a summary of each dump (format, size, columns) so it knows what's available and can query the files using `jq` when needed.

**Best for:**

* Service mapping tables
* On-call rosters
* Environment configuration indexes
* Resource inventories

### Recommended Formats

<Tip>
  **CSV with headers** and **JSON** are the recommended formats. Annie automatically detects the format and converts CSVs to JSONL for efficient querying.
</Tip>

### Examples

<AccordionGroup>
  <Accordion icon="table" title="Service Mapping (CSV)">
    ```csv theme={null}
    service_name,owner,tier,environment,dependencies,dashboard
    payment-api,@payments-team,critical,prod,stripe;redis;dynamodb,Payment Overview
    auth-service,@platform-team,critical,prod,auth0;redis;postgres,Auth Health
    order-processor,@commerce-team,high,prod,postgres;sqs;payment-api,Order Pipeline
    notification-svc,@platform-team,medium,prod,ses;sqs,Notifications
    ```
  </Accordion>

  <Accordion icon="table" title="On-Call Roster (CSV)">
    ```csv theme={null}
    team,primary,secondary,escalation_contact,schedule_link
    payments,alice@company.com,bob@company.com,payments-oncall@company.com,https://pagerduty.com/schedules/payments
    platform,charlie@company.com,diana@company.com,platform-lead@company.com,https://pagerduty.com/schedules/platform
    data,eve@company.com,frank@company.com,data-oncall@company.com,https://pagerduty.com/schedules/data
    ```
  </Accordion>

  <Accordion icon="code" title="Environment Config (JSON)">
    ```json theme={null}
    {
      "environments": {
        "prod": {
          "region": "us-east-1",
          "account_id": "123456789",
          "vpc_id": "vpc-abc123",
          "maintenance_window": "Sundays 2-4 AM UTC"
        },
        "staging": {
          "region": "us-east-1",
          "account_id": "987654321",
          "vpc_id": "vpc-def456",
          "maintenance_window": "No restrictions"
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Knowledge Platforms

For full documentation libraries that are too large for knowledge entries or dumps, connect Annie to your knowledge platform. Annie searches these on demand during investigations.

<CardGroup cols={3}>
  <Card title="Jira" icon="jira" href="/pages/integration/jira">
    Search tickets, issues, and project documentation.
  </Card>

  <Card title="Confluence" icon="confluence" href="/pages/integration/confluence">
    Search wiki pages, runbooks, and team documentation.
  </Card>

  <Card title="Guru" icon="book" href="/pages/integration/guru">
    Search verified knowledge cards and team documentation.
  </Card>
</CardGroup>

## Get Started

<CardGroup cols={2}>
  <Card title="Create Account" icon="user-plus" href="https://app.anyshift.io/">
    Sign up for Anyshift
  </Card>

  <Card title="Request Demo" icon="phone" href="https://calendly.com/roxane-fischer/30-zoom-meeting?back=1">
    See Custom Knowledge in action
  </Card>
</CardGroup>