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

# Introduction

> AIDA (AODocs Intelligent Document Assistant) is an AI-powered layer on top of the AODocs platform. It provides chat, metadata extraction, document validation, translation, and more — all operating on your existing AODocs libraries and documents.

## Prerequisites

* AIDA must be enabled on your tenant by AODocs support
* AIDA must be enabled on each library you want to use it with (`PUT /assistant/api/v1/tenants/{tenant}/libraries/{library_id}`)
* Authentication uses the same OAuth2 Bearer token as the AODocs core API — your client ID must be whitelisted in AODocs

## Document Assistant API 1.1.0

```text Base URL theme={null}
https://document-assistant.us.aodocs.app
```

<Info>
  **Choose your region.** AIDA is hosted in two production regions. Use the base
  URL that matches where your tenant is provisioned, and select the matching
  server in the API playground's base URL selector when trying requests.

  | Region        | Base URL                                   |
  | ------------- | ------------------------------------------ |
  | United States | `https://document-assistant.us.aodocs.app` |
  | Europe        | `https://document-assistant.eu.aodocs.app` |
</Info>

<Columns>
  <Card title="Chat v2" icon="message" iconType="solid" href="/api-reference/chat-v2">
    Semantic question answering over your documents. Structured response by paragraph with source references. Recommended for all new integrations.
  </Card>

  <Card title="Chat v1" icon="comments" iconType="solid" href="/api-reference/chat">
    Legacy chat endpoint. Returns a single text block. Fields `library_id` and `document_id` are deprecated — use `library_ids` / `document_ids`.
  </Card>

  <Card title="Metadata Extraction" icon="tags" iconType="solid" href="/api-reference/metadata">
    Extract structured fields from documents using predefined or custom schemas. Supports confidence scoring and evaluation workflows.
  </Card>

  <Card title="Document Validation" icon="circle-check" iconType="solid" href="/api-reference/document_validation">
    Validate documents against rules (regex, blacklist, LLM-based). Returns violations with severity and whitelist support.
  </Card>

  <Card title="Translation" icon="language" iconType="solid" href="/api-reference/translation">
    Translate document content. Operates on AODocs document identifiers.
  </Card>

  <Card title="Document Split" icon="scissors" iconType="solid" href="/api-reference/document_split">
    Split a document into logical sections based on content analysis.
  </Card>

  <Card title="Document Similarity" icon="equals" iconType="solid" href="/api-reference/document_similarity">
    Compute similarity scores between documents within a library.
  </Card>

  <Card title="Document Conflict" icon="triangle-exclamation" iconType="solid" href="/api-reference/document_conflict">
    Detect conflicts between a source document and a class of target documents. Asynchronous — results delivered via Pub/Sub.
  </Card>

  <Card title="Tenant & Library" icon="building" iconType="solid" href="/api-reference/tenant">
    Activate and configure AIDA on a tenant or library. Monitor indexation status.
  </Card>

  <Card title="A2A" icon="robot" iconType="solid" href="/api-reference/a2a">
    Agent-to-agent protocol. Exposes AIDA as an agent card for integration with external AI orchestration systems.
  </Card>
</Columns>

## Relation to the AODocs core API

AIDA uses the same identifiers as the AODocs core API — tenant IDs, library IDs, and document IDs are interchangeable between the two APIs. Authentication is shared. See the [Authentication](/authentication) section for details.