Core Concepts

Piri uses R-tree data structures for spatial indexing. R-trees organize geometric data in a tree structure that enables efficient querying.

Overview

Core Concepts is framed as an execution surface instead of a generic article. Use it when you need direct context, concise operational detail, and a fast path into guides.

Concepts

article

Guides

Learn how to build with Piri.

schema

Architecture

Piri is built in Go with a clean layered architecture:

cloud_upload

Deployment

Operational guidance for this part of the docs tree.

Agentic Tools

guides_concepts.json

{
  "tool_name": "guides_concepts",
  "scope": "Guides",
  "description": "Piri uses R-tree data structures for spatial indexing. R-trees organize geometric data in a tree structure that enables efficient querying.",
  "parameters": {
    "workspace": "default",
    "surface": "guides",
    "focus": "Core Concepts",
    "mode": "reference"
  }
}

Implementation

docs_guides.ts

import { PiriClient } from '@piri/sdk'

const client = new PiriClient({
  apiKey: process.env.PIRI_API_KEY!,
  baseUrl: process.env.PIRI_BASE_URL!,
})

async function runDocsFlow() {
  const result = await client.request('/v1/workflows', {
    method: 'POST',
    body: {
      page: 'Core Concepts',
      section: 'Guides',
      intent: 'load'
    }
  })

  return result
}

runDocsFlow().then(console.log)