FeatureRecipe
semantic-caching-azure-api-management
Realizes core/semantic-caching on core/gateway/azure-api-management's terraform Recipe; a Release binds it in its Manifest. It writes a cache lookup and a cache store into the API's policy and emits no file. embedding_model names an API Management backend for an embeddings model that the instance already holds and reaches with its managed identity; the instance also needs a Redis cache with RediSearch configured as its external cache. The build cannot see either, so the gateway's Recipe halts until the operator affirms that cache by setting infra.cache_serves_vector_search. A reply is kept for ttl_seconds, apart per API and per API Management subscription, so it honours scope key and refuses end_user by name: the API validates no end user's token, so the gateway has no verified end user to keep apart. Key needs the subscription key the API requires by default. similarity_threshold is written as score-threshold, 1 minus the threshold, reading Azure's score as a cosine distance: Microsoft gives the score's range and direction, lower requiring closer prompts, but not its measure. Microsoft warns a similar prompt can be served a reply that is wrong for it. That the policy applies as described is not observed by any build.
Provenance
- Content digest
- sha256:8a64351412e440523d3bf50c49c4721703631067b28f6c419835d8afc9aff063
- Published
- 2026-11-10T10:16:52Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:fd14e00f53267cbdbb31207ae1e80540d0c3087d689a703a36ad79d8f3eb0c0e
Reference at this version
oci://hub.aggrega.ai/featurerecipe/terraform/semantic-caching-azure-api-management:1.0.0- Target
- —
- Implements
- core/semantic-caching:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
No provides templates declared.
Inject mapping
azure_api_management:
semantic_cache_lookup: {{ printf "<llm-semantic-cache-lookup score-threshold=\"%s\" embeddings-backend-id=\"%s\" embeddings-backend-auth=\"system-assigned\">\n <vary-by>@(context.Api.Id)</vary-by>\n <vary-by>@(context.Subscription.Id)</vary-by>\n</llm-semantic-cache-lookup>" .locals.score_threshold .values.embedding_model | toJson }}
semantic_cache_store: {{ printf "<llm-semantic-cache-store duration=\"%v\" />" .values.ttl_seconds | toJson }}
subscription_scoped.{{ .attachment_name }}: "core/semantic-caching"
Workload
No workload template declared.
Locals
| Name | Template |
|---|---|
| score_threshold | {{ printf "%.6g" (subf 1.0 (float64 .values.similarity_threshold)) }} |
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplements
core/semantic-caching:1.0.0
Used by
Nothing in the catalog depends on this entity.