PinnedKnowledgeBinding
A Knowledge binding as an Agent version froze it at publish (1.53.0): every field explicit, the version of a pinned binding fixed, so a later edit of the draft reaches Calls only through a new Agent version.
An object with 13 fields.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
budget_ms | integer | yes | How long before_model waits for a context retrieval; one that misses it is abandoned for the Turn, flagged retrieval_skipped. |
filter | KnowledgeFilter or null | yes | |
knowledge_base_id | KnowledgeBaseId | yes | |
max_context_tokens | integer or null | yes | Null for the version's default. |
min_score | number or null | yes | Null for the version's default. |
name | KnowledgeBindingName | yes | |
rerank | boolean or null | yes | Null for the version's default. |
states | array or null | yes | Null for every state. |
top_k | integer or null | yes | Null for the version's default. |
track | KnowledgeBindingTrack | yes | |
use | KnowledgeBindingUse | yes | |
version | integer or null | yes | The version a pinned binding froze, the one active at publish; null for active, which dispatch resolves. |
when | string or null | yes | A ZEN expression over intents, slots and variables, evaluated after on_transcript; the binding applies when it is true. |