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

# Intelligence Operations

> Operate Starfire AI runs, research, FORGE builds, artifacts, Knowledge, retrieval, embeddings, search, and tools from Control Center.

# Intelligence operations

The Intelligence area brings together the operational systems behind Starfire's higher-order workloads: research, FORGE, artifacts, Knowledge, retrieval, embeddings, search, and tools.

## Runs

Runs provide a common operational model for work that may involve multiple model and tool calls.

Operators can use run metadata to understand:

* owning user or organization
* project context
* workload type
* status and duration
* model usage
* credits
* related resources
* failure stage

## Research operations

A research dashboard can surface operational measures such as:

* research run count
* average sources or queries
* citation-verification state
* conflicts detected
* average credits
* search-provider distribution

A run detail view can expose stages like planner, tasks, queries, source collection, claims, verification, model calls, and usage metadata.

## FORGE build operations

Build administration can expose:

* active and queued builds
* completed and failed jobs
* auto-repair outcomes
* average duration
* current stage
* validation status
* resulting artifacts

Authorized operators can cancel, retry, or requeue according to the current job state and permission model.

## Artifact operations

Artifact administration focuses on metadata and storage health, including:

* artifact volume
* storage consumed
* expiration
* failed uploads
* orphaned storage objects
* cleanup state

Operational visibility should not imply unrestricted browsing of private artifact contents.

## Knowledge operations

Knowledge administration can surface:

* knowledge bases
* source/document counts
* chunks
* embeddings
* indexing failures
* stale sources
* storage

Operators can use administrative actions such as retry indexing, rebuild an index, recalculate supported embeddings, or inspect retrieval behavior when those capabilities are enabled.

## Tool administration

Starfire tools can include product capabilities such as web search, URL reading, workspace retrieval, calculation, build filesystem access, code validation, archive handling, and artifact packaging.

Tool configuration can carry concepts such as:

* enabled state
* allowed plans
* timeout
* maximum calls per run
* approval requirement
* usage/cost multiplier

This becomes especially important for agent workflows and FORGE because tools can create additional cost or side effects beyond the model call itself.

<Warning>
  Changing tool, build, retrieval, or research configuration can affect many users. Verify scope and rollout before applying a platform-wide change.
</Warning>