Skip to content

Commit 97caee1

Browse files
committed
another batch of low-hanging fruit
1 parent 3806fb9 commit 97caee1

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+1764
-1719
lines changed

advocacy_docs/edb-postgres-ai/ai-factory/gen-ai/builder/libraries/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Data Sources → Libraries → Knowledge Bases → Retrievers → Assistants →
3737

3838
For background on key concepts, see:
3939

40-
- [AI Factory Concepts](../../learn/explained/ai-factory-concepts)
40+
- [AI Factory Concepts](/edb-postgres-ai/ai-factory/learn/explained/ai-factory-concepts/)
4141
- [Knowledge Bases explained](/edb-postgres-ai/ai-factory/learn/explained/knowledge-bases-explained/)
4242
- [Retrievers explained](../../learn/explained/retrievers-explained)
4343
- [Retrieval Augmented Generation (RAG)](/edb-postgres-ai/ai-factory/learn/explained/terminology/#retrieval-augmented-generation-rag)
@@ -114,7 +114,7 @@ For procedural steps, see the How-to Guides in this section.
114114

115115
## Related topics
116116

117-
- [AI Factory Concepts](../../learn/explained/ai-factory-concepts)
117+
- [AI Factory Concepts](/edb-postgres-ai/ai-factory/learn/explained/ai-factory-concepts/)
118118
- [Knowledge Bases explained](/edb-postgres-ai/ai-factory/learn/explained/knowledge-bases-explained/)
119119
- [Retrievers explained](../../learn/explained/retrievers-explained)
120120
- [Retrieval Augmented Generation (RAG)](/edb-postgres-ai/ai-factory/learn/explained/terminology/#retrieval-augmented-generation-rag)

advocacy_docs/edb-postgres-ai/ai-factory/learn/explained/terminology.mdx

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -37,23 +37,23 @@ Natural language processing (NLP) enables computers to understand and generate h
3737

3838
### Large language models (LLMs)
3939

40-
LLMs are large deep learning models trained on massive text corpora. In AI Factory, they drive [Assistants](assistants-explained), Retrieval-Augmented Generation (RAG), and various model pipelines, deployed using [Model Serving](../model/serving).
40+
LLMs are large deep learning models trained on massive text corpora. In AI Factory, they drive [Assistants](assistants-explained), Retrieval-Augmented Generation (RAG), and various model pipelines, deployed using [Model Serving](/edb-postgres-ai/ai-factory/model/serving/).
4141

4242
[Learn more](http://huggingface.co/blog/llm)
4343

4444
### Embeddings
4545

46-
Embeddings are vector representations of data that capture semantic meaning. AI Factory Pipelines create embeddings used in [Knowledge Bases](knowledge-bases-explained) and served through the [Vector Engine](../vector-engine) to enable semantic search and RAG.
46+
Embeddings are vector representations of data that capture semantic meaning. AI Factory Pipelines create embeddings used in [Knowledge Bases](knowledge-bases-explained) and served through the [Vector Engine](/edb-postgres-ai/ai-factory/vector-engine/) to enable semantic search and RAG.
4747

4848
[Learn more](http://sebastianraschka.com/blog/2023/llm-embeddings.html)
4949

5050
### Vector databases
5151

52-
Vector databases store embeddings and enable fast similarity search. AI Factory provides this through the [Vector Engine](../vector-engine), built on the open-source [pgvector](http://github.com/pgvector/pgvector) extension, integrated directly with Postgres.
52+
Vector databases store embeddings and enable fast similarity search. AI Factory provides this through the [Vector Engine](/edb-postgres-ai/ai-factory/vector-engine/), built on the open-source [pgvector](http://github.com/pgvector/pgvector) extension, integrated directly with Postgres.
5353

5454
### Retrieval-augmented generation (RAG)
5555

56-
RAG combines vector search with LLM generation to ground model responses in relevant documents. In AI Factory, it is implemented through [Knowledge Bases](knowledge-bases-explained), [Retrievers](retrievers-explained), and [Model Serving](../model/serving).
56+
RAG combines vector search with LLM generation to ground model responses in relevant documents. In AI Factory, it is implemented through [Knowledge Bases](knowledge-bases-explained), [Retrievers](retrievers-explained), and [Model Serving](/edb-postgres-ai/ai-factory/model/serving/).
5757

5858
[Intro to RAG](http://huggingface.co/blog/rag)
5959

@@ -63,19 +63,19 @@ RAG combines vector search with LLM generation to ground model responses in rele
6363

6464
### Intelligent database management
6565

66-
Intelligent database management applies AI to optimize Postgres performance and operations. AI Factory extends this with intelligent retrieval and search using [Vector Engine](../vector-engine) and Pipelines.
66+
Intelligent database management applies AI to optimize Postgres performance and operations. AI Factory extends this with intelligent retrieval and search using [Vector Engine](/edb-postgres-ai/ai-factory/vector-engine/) and Pipelines.
6767

6868
### In-database machine learning (In-DB ML)
6969

70-
In-DB ML enables running vector search and ML pipelines inside Postgres, reducing data movement and latency. AI Factory implements this through [Vector Engine](../vector-engine) and [Pipelines](../pipeline).
70+
In-DB ML enables running vector search and ML pipelines inside Postgres, reducing data movement and latency. AI Factory implements this through [Vector Engine](/edb-postgres-ai/ai-factory/vector-engine/) and [Pipelines](/edb-postgres-ai/ai-factory/pipeline/).
7171

7272
### Vector search in Postgres
7373

74-
Vector search allows you to query embeddings directly within Postgres. AI Factory uses [pgvector](http://github.com/pgvector/pgvector) to power this capability through the [Vector Engine](../vector-engine), supporting Knowledge Bases and RAG.
74+
Vector search allows you to query embeddings directly within Postgres. AI Factory uses [pgvector](http://github.com/pgvector/pgvector) to power this capability through the [Vector Engine](/edb-postgres-ai/ai-factory/vector-engine/), supporting Knowledge Bases and RAG.
7575

7676
### AIDB
7777

78-
AIDB (AI-in-Database) brings vector search, embedding pipelines, and future ML capabilities to HCP-managed Postgres clusters. It is the foundation for AI Factory [Pipelines](../pipeline) and Knowledge Bases.
78+
AIDB (AI-in-Database) brings vector search, embedding pipelines, and future ML capabilities to HCP-managed Postgres clusters. It is the foundation for AI Factory [Pipelines](/edb-postgres-ai/ai-factory/pipeline/) and Knowledge Bases.
7979

8080
### Natural language interfaces to databases
8181

@@ -87,21 +87,21 @@ Natural language interfaces enable users to query Postgres using natural languag
8787

8888
### AI-accelerated hardware
8989

90-
AI Factory uses GPU-accelerated Kubernetes clusters to serve deep learning models and high-throughput inference. Model workloads in [Model Serving](../model/serving) run on GPU-enabled nodes.
90+
AI Factory uses GPU-accelerated Kubernetes clusters to serve deep learning models and high-throughput inference. Model workloads in [Model Serving](/edb-postgres-ai/ai-factory/model/serving/) run on GPU-enabled nodes.
9191

9292
[Learn more](http://developer.nvidia.com/cuda-gpus)
9393

9494
### KServe
9595

96-
KServe is the open-source Kubernetes-native framework AI Factory uses to deploy and manage ML models. It provides InferenceServices, autoscaling, and observability for AI Factory [Model Serving](../model/serving).
96+
KServe is the open-source Kubernetes-native framework AI Factory uses to deploy and manage ML models. It provides InferenceServices, autoscaling, and observability for AI Factory [Model Serving](/edb-postgres-ai/ai-factory/model/serving/).
9797

9898
[KServe documentation](http://kserve.github.io/website/)
9999

100100
### Model Serving
101101

102102
Model Serving deploys AI models as production-grade inference services, using KServe under the hood. It supports LLMs, embedding models, vision models, and custom AI workloads.
103103

104-
See: [Model Serving](../model/serving), [Model Serving explained](model-serving-explained)
104+
See: [Model Serving](/edb-postgres-ai/ai-factory/model/serving/), [Model Serving explained](model-serving-explained)
105105

106106
* * *
107107

@@ -135,7 +135,7 @@ See: [Hybrid Manager AI Factory](/edb-postgres-ai/hybrid-manager/ai-factory)
135135

136136
Pipelines automate the creation of embeddings and Knowledge Bases from data sources in your control, ensuring transparency and auditability.
137137

138-
See: [Pipelines overview](../pipeline)
138+
See: [Pipelines overview](/edb-postgres-ai/ai-factory/pipeline/)
139139

140140
### Knowledge Bases
141141

@@ -145,19 +145,19 @@ See: [Knowledge Bases explained](knowledge-bases-explained)
145145

146146
### Model Serving
147147

148-
Model Serving deploys models using Kubernetes-native KServe and integrates with the [Model Library](.edb-postgres-ai/ai-factory/model/library). It powers Assistants, Knowledge Bases, and custom AI applications.
148+
Model Serving deploys models using Kubernetes-native KServe and integrates with the [Model Library](/edb-postgres-ai/ai-factory/model/library/). It powers Assistants, Knowledge Bases, and custom AI applications.
149149

150-
See: [Model Serving](../model/serving)
150+
See: [Model Serving](/edb-postgres-ai/ai-factory/model/serving/)
151151

152152
* * *
153153

154154
## Additional concepts
155155

156156
### Image and Model Library
157157

158-
The Image and Model Library in Hybrid Manager manages container images for both Postgres and AI model deployments. The [Model Library](.edb-postgres-ai/ai-factory/model/library) provides an AI-focused view, supporting Model Serving and governed image workflows.
158+
The Image and Model Library in Hybrid Manager manages container images for both Postgres and AI model deployments. The [Model Library](/edb-postgres-ai/ai-factory/model/library/) provides an AI-focused view, supporting Model Serving and governed image workflows.
159159

160-
See: [Model Image Library explained](/edb-postgres-ai/hybrid-manager/learn/explained/model-image-library)
160+
See: [Model Image Library explained](/edb-postgres-ai/hybrid-manager/ai-factory/learn/explained/model-image-library-explained/)
161161

162162
### NVIDIA NIM
163163

advocacy_docs/edb-postgres-ai/ai-factory/learn/how-to/model-library/define-repository-rules.mdx

Lines changed: 59 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -10,39 +10,39 @@ This guide explains how to define **Repository Rules** to control which model im
1010

1111
Repository Rules help you manage:
1212

13-
- **Scope** of image discovery
14-
- **Governance** over which images are exposed
15-
- **Version control** by controlling which tags are visible
13+
- **Scope** of image discovery
14+
- **Governance** over which images are exposed
15+
- **Version control** by controlling which tags are visible
1616

1717
## Who should use this guide?
1818

19-
- AI platform admins integrating private registries
20-
- DevOps engineers managing container registry integrations
21-
- Security/compliance teams governing AI model image usage
19+
- AI platform admins integrating private registries
20+
- DevOps engineers managing container registry integrations
21+
- Security/compliance teams governing AI model image usage
2222

2323
## What this enables
2424

25-
- You can precisely control which image repositories HCP syncs.
26-
- You can filter which tags within each repository are exposed.
27-
- You can govern which images are available in the Model Library for deployment.
25+
- You can precisely control which image repositories HCP syncs.
26+
- You can filter which tags within each repository are exposed.
27+
- You can govern which images are available in the Model Library for deployment.
2828

2929
## Estimated time to complete
3030

3131
5–10 minutes per Repository Rule.
3232

3333
## Prerequisites
3434

35-
- You must have already [Integrated your Private Registry](integrate-private-registry).
36-
- Your registry must appear in **AI Factory > Model Library > Manage Repositories**.
35+
- You must have already [Integrated your Private Registry](integrate-private-registry).
36+
- Your registry must appear in **AI Factory > Model Library > Manage Repositories**.
3737

3838
## Understanding Repository Rules
3939

4040
Repository Rules are attached to each configured registry.
4141

4242
They allow you to define:
4343

44-
- **Which repositories** to discover
45-
- **Which tags** within those repositories to expose
44+
- **Which repositories** to discover
45+
- **Which tags** within those repositories to expose
4646

4747
This prevents accidental exposure of test images, unvetted model builds, or entire registry contents.
4848

@@ -52,16 +52,16 @@ Repository Rules are **evaluated periodically** — newly pushed images matching
5252

5353
Each rule typically includes:
5454

55-
| Field | Description |
56-
|-------|-------------|
57-
| Repository Name | Name of the repository to include (exact match or pattern) |
58-
| Tag Filter | (Optional) Filter for tag names (exact match, prefix, regex) |
59-
| Rule Enabled | Whether this rule is currently active |
55+
| Field | Description |
56+
| --------------- | ------------------------------------------------------------ |
57+
| Repository Name | Name of the repository to include (exact match or pattern) |
58+
| Tag Filter | (Optional) Filter for tag names (exact match, prefix, regex) |
59+
| Rule Enabled | Whether this rule is currently active |
6060

6161
Example:
6262

63-
| Repository Name | Tag Filter |
64-
|-----------------|------------|
63+
| Repository Name | Tag Filter |
64+
| -------------------------- | ------------- |
6565
| `my-company/llama3-models` | `^release-.*` |
6666

6767
→ Only tags starting with `release-` in `my-company/llama3-models` will appear.
@@ -70,22 +70,23 @@ Example:
7070

7171
### 1. Navigate to Repository Rules
7272

73-
- Go to:
73+
- Go to:
7474

7575
`AI Factory > Model Library > Manage Repositories`
7676

77-
- Click **Manage Rules** for your desired registry.
77+
- Click **Manage Rules** for your desired registry.
7878

7979
### 2. Add a Repository Rule
8080

81-
- Click **Add Rule**.
82-
- Fill in:
81+
- Click **Add Rule**.
82+
83+
- Fill in:
8384

84-
- **Repository Name** — required
85-
- **Tag Filter** — optional
86-
- Enable/Disable toggle
85+
- **Repository Name** — required
86+
- **Tag Filter** — optional
87+
- Enable/Disable toggle
8788

88-
- Click **Save**.
89+
- Click **Save**.
8990

9091
The rule will appear in the rules list.
9192

@@ -95,73 +96,73 @@ HCP will apply rules on the next registry sync cycle.
9596

9697
If your UI supports manual sync:
9798

98-
- Click **Sync Now** after adding/updating a rule.
99+
- Click **Sync Now** after adding/updating a rule.
99100

100101
### 4. Verify Model Library content
101102

102-
- Go to **AI Factory > Model Library**.
103-
- Use filters to browse images from your registry.
104-
- Confirm only desired repositories/tags appear.
103+
- Go to **AI Factory > Model Library**.
104+
- Use filters to browse images from your registry.
105+
- Confirm only desired repositories/tags appear.
105106

106107
## Example Use Cases
107108

108109
### Basic: Restrict to a single repo
109110

110-
| Repository Name | Tag Filter |
111-
|-----------------|------------|
111+
| Repository Name | Tag Filter |
112+
| ------------------- | ------------------ |
112113
| `my-org/nim-models` | (blank — all tags) |
113114

114115
→ All tags in `my-org/nim-models` will appear.
115116

116117
### Advanced: Filter to production tags
117118

118119
| Repository Name | Tag Filter |
119-
|-----------------|------------|
120-
| `models/gpt4` | `^prod-.*` |
120+
| --------------- | ---------- |
121+
| `models/gpt4` | `^prod-.*` |
121122

122123
→ Only tags starting with `prod-` will appear.
123124

124125
### Multi-repo governance
125126

126-
- Add multiple Repository Rules per registry as needed.
127-
- Use Tag Filters to align with your model promotion pipelines (dev, staging, prod).
127+
- Add multiple Repository Rules per registry as needed.
128+
- Use Tag Filters to align with your model promotion pipelines (dev, staging, prod).
128129

129130
## Tips & Best Practices
130131

131-
- **Be explicit** — add Repository Rules for only the repositories you want to expose.
132-
- Use **Tag Filters** to enforce version governance and CI/CD promotion stages.
133-
- Regularly **audit Repository Rules** to ensure compliance with internal image standards.
134-
- If your registry uses structured tagging (e.g., `prod-`, `test-`), leverage Tag Filters to separate experimental from production models.
132+
- **Be explicit** — add Repository Rules for only the repositories you want to expose.
133+
- Use **Tag Filters** to enforce version governance and CI/CD promotion stages.
134+
- Regularly **audit Repository Rules** to ensure compliance with internal image standards.
135+
- If your registry uses structured tagging (e.g., `prod-`, `test-`), leverage Tag Filters to separate experimental from production models.
135136

136137
## Troubleshooting
137138

138139
### Images not appearing
139140

140-
- Check that Repository Rule exists for the desired repo.
141-
- If using Tag Filter — verify tags match the filter exactly.
142-
- Check when the last sync ran; trigger manual sync if needed.
141+
- Check that Repository Rule exists for the desired repo.
142+
- If using Tag Filter — verify tags match the filter exactly.
143+
- Check when the last sync ran; trigger manual sync if needed.
143144

144145
### Too many images appearing
145146

146-
- Refine Repository Rules.
147-
- Add Tag Filters to narrow scope.
147+
- Refine Repository Rules.
148+
- Add Tag Filters to narrow scope.
148149

149150
### Repository Rule has no effect
150151

151-
- Confirm repository name is exact (case sensitive).
152-
- Ensure Rule is enabled.
153-
- Trigger manual sync and check HCP logs if issue persists.
152+
- Confirm repository name is exact (case sensitive).
153+
- Ensure Rule is enabled.
154+
- Trigger manual sync and check HCP logs if issue persists.
154155

155156
## Summary
156157

157-
- Repository Rules govern which image repositories and tags appear in Model Library.
158-
- You can scope exposure by repository name and tag filters.
159-
- This supports governance, version control, and security best practices.
160-
- Fine-grained control helps ensure only vetted model images are deployed.
158+
- Repository Rules govern which image repositories and tags appear in Model Library.
159+
- You can scope exposure by repository name and tag filters.
160+
- This supports governance, version control, and security best practices.
161+
- Fine-grained control helps ensure only vetted model images are deployed.
161162

162163
## Related Links
163164

164-
- [Model Library Explained](/edb-postgres-ai/ai-factory/learn/explained/model-library-explained)
165-
- [Integrate Private Registry with Model Library](integrate-private-registry)
166-
- [Deploy AI Models from Model Library](deploy-ai-models)
167-
- [Image and Model Library Explained](/edb-postgres-ai/hybrid-manager/learn/explained/model-image-library)
165+
- [Model Library Explained](/edb-postgres-ai/ai-factory/learn/explained/model-library-explained)
166+
- [Integrate Private Registry with Model Library](integrate-private-registry)
167+
- [Deploy AI Models from Model Library](deploy-ai-models)
168+
- [Image and Model Library Explained](/edb-postgres-ai/hybrid-manager/ai-factory/learn/explained/model-image-library-explained/)

0 commit comments

Comments
 (0)