{
  "schema_version": 2,
  "id": "develop/ai/context-engine/agent-playbooks/concepts",
  "title": "Redis Agent Playbooks concepts",
  "url": "https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/concepts/",
  "summary": "Understand playbooks, entries, versions, publication, discovery, proposals, and evidence.",
  "tags": [
    "docs",
    "develop",
    "ai"
  ],
  "last_updated": "2026-11-02T15:54:35-08:00",
  "page_type": "content",
  "content_hash": "dfb19ebd98aba928461534eac29d0b51e3aca506a4f5bf20801ee18504e8ee65",
  "sections": [
    {
      "id": "playbooks",
      "title": "Playbooks",
      "role": "overview",
      "text": "Redis Agent Playbooks store reusable answers and procedures as **entries** inside **playbooks**. A playbook is a registry with its own access grants and retrieval settings. Publish an entry **version** for retrieval, then revise new content while agents use that publication.\n\nEmbeddings and semantic search match agent tasks with relevant entries. Discovery settings control similarity thresholds and result limits. Your application supplies the task text and retrieval options.\n\nA **proposal** inbox holds suggested FAQs, skills, and evidence for review.\n\nAccess **grants** apply across a playbook. For example, you can give a support agent **read** access to a support playbook and give a content reviewer permission to **write** or **publish**. Use separate playbooks when workloads must not share visibility. Attribute filters help select content within a playbook, but do not replace access grants.\n\nPlaybook API keys can grant these actions:\n\n| Action    | What it allows                                                                                          |\n| --------- | ------------------------------------------------------------------------------------------------------- |\n| `read`    | Retrieve published knowledge, list and inspect entry summaries, and read proposals.                     |\n| `write`   | Create entries, append versions, inspect drafts, delete entries, and review proposals. Includes `read`. |\n| `publish` | Publish or withdraw entries and inspect versions. Includes `read`.                                      |\n| `propose` | Create proposals and attach evidence. Includes `read`.                                                  |\n\n`write` does not include `publish` or `propose`. You can assign authoring and publication to different people or applications."
    },
    {
      "id": "entries",
      "title": "Entries",
      "role": "content",
      "text": "An entry is a reusable answer or procedure. Redis Agent Playbooks support two types:\n\n- A **FAQ** pairs a question with an answer. Retrieval returns the full answer directly.\n- A **skill (Agent Skill)** packages instructions and optional supporting files for a procedure. Retrieval returns a preview so an agent can decide whether to load the instructions and resources.\n\nAn entry keeps the same identifier across versions. You can also assign an immutable, human-readable entry key when you create it. Use the entry identifier to maintain existing content; creating another entry produces a separate history.\n\nBoth types can include optional intents, attributes, and metadata:\n\n- **Intents** are optional task paraphrases returned on discovery to help an agent or application interpret the entry.\n- **Attributes** support exact-match retrieval filters, such as locale or audience.\n- **Metadata** holds additional agent or application context; retrieval filters do not search it.\n\nFor fields and types, see the [entry model](https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/api-reference#schema/StableEntry)."
    },
    {
      "id": "versions",
      "title": "Versions",
      "role": "compatibility",
      "text": "A version is a complete, immutable snapshot of an entry's authored content. Updating an entry appends a new version rather than editing the existing snapshot.\n\nThe latest version and the published version can differ. Version 2 of a refund procedure can remain under review while agents retrieve version 1. Publishing version 2 switches retrieval to the update and retains version 1 for rollback.\n\n![Creating an entry starts an unpublished version 1. Publishing version 1 makes it retrievable. Appending version 2 keeps version 1 published until you publish version 2. You can publish version 1 again to roll back, or withdraw the entry so agents retrieve nothing.](https://redis.io/docs/latest/images/ai/context-engine/agent-playbook-versions.svg)\n\nManagement operations let you inspect drafts and historical versions with the required permissions. See the [version model](https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/api-reference#schema/Version) for fields and types."
    },
    {
      "id": "publication",
      "title": "Publication",
      "role": "content",
      "text": "Publication selects the version of an entry that search and discovery can return.\n\nPublish a reviewed version to make it available to agents. Publish an earlier version to roll back. Withdraw the publication to stop serving the entry while retaining its history. Delete the entry to remove it and its versions permanently."
    },
    {
      "id": "discovery",
      "title": "Discovery",
      "role": "content",
      "text": "Discovery returns relevant, published FAQ answers and skill previews for an agent task.\n\nSimilarity scores help rank relevant content. Filter attributes narrow the audience or topic. Pins let an application select known published skills or FAQs regardless of similarity.\n\nFor skills, the agent selects a preview, loads its instructions, and fetches supporting files as needed. Your application controls how it uses that content."
    },
    {
      "id": "proposals",
      "title": "Proposals",
      "role": "content",
      "text": "A proposal is a suggested playbook entry awaiting expert review. See the [proposal model](https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/api-reference#schema/GetProposalResponseContent) for fields and types.\n\nA human or agent can suggest a FAQ or skill, edit the candidate, or attach evidence.\n\nAccepting a reviewed proposal *promotes* its FAQ or skill candidate into a new *unpublished* entry. Publication remains a separate action. Proposals do not revise existing entries."
    },
    {
      "id": "evidence",
      "title": "Evidence",
      "role": "content",
      "text": "Evidence gives reviewers source context for a proposal. It can come from background extraction or an authorized client acting for a human or agent. See the [evidence model](https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/api-reference#schema/ProposalEvidence) for fields and types.\n\nMore evidence means more submitted observations, not greater factual accuracy. Check the candidate against its sources before accepting and publishing it.\n\nSee [Review proposals](https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/proposals) for the procedure."
    },
    {
      "id": "extraction",
      "title": "Extraction",
      "role": "content",
      "text": "**Extraction** turns agent interactions into suggested reusable knowledge. Redis Agent Memory stores the conversations; Redis Agent Playbooks use those conversations to propose answers for review. For example, a support conversation that resolves a refund question can suggest a FAQ for future agents.\n\nAn administrator connects a Redis Agent Memory store to a playbook through an **extraction binding** and enables a background worker. The worker reads eligible idle sessions, derives questions and answers from their events or summaries, and compares them with published FAQs and open proposals. It can create a proposal or attach another observation as evidence to an existing open proposal. An observation already covered by a published FAQ can require no new proposal.\n\nYou can also build your own producer that calls the proposal and evidence APIs directly. Your application chooses the source material, generates candidates, and decides whether to create a proposal or add evidence. Both approaches use the same review process: acceptance creates an unpublished entry, and publication makes the reviewed version available to agents.\n\nBackground extraction supports FAQs. Applications can submit FAQ or skill proposals directly. See [Automate proposal generation](https://redis.io/docs/latest/develop/ai/context-engine/agent-playbooks/proposals#automate-proposal-generation) for both approaches and [extraction setup](https://redis.io/docs/latest/operate/iris/agent-playbook/manage-playbook#automatic-faq-extraction) for administration."
    }
  ],
  "examples": []
}