Haystack

Search Haystack for people, teams, posts, events, knowledge pages, glossary terms, files, and links. Each result includes a `display_title` (human-readable name) and a `url` with an absolute link back to the relevant page in Haystack. Results also include `entity_type` and, when present, `entity_id` from the typed hit (not from the url). Pass both to `haystack_get_entity` only when `entity_id` is set: that is `knowledge_page`, `post`, `event`, `glossary_term`, and `link`. `person`, `team`, and `file` hits omit `entity_id` because they are not fetchable; files remain available via the signed `url`, and people/teams have no long-form body. Do not parse Haystack URLs for ids. When presenting results to the user, always render each result as a clickable markdown link using its `display_title` as the link text and `url` as the target (for example `[display_title](url)`), so the user can open it directly in Haystack. When a `summary` is present (first page only), it is an AI-generated answer grounded in the top results; lead with it and then cite the supporting results as links. Follow-up pages omit `summary`; present only the returned links. Use `next_page_token` as the `page_token` on a follow-up call to page through more results.

haystack_ai_search

Load the full document for a Haystack entity identified by `entity_type` and `entity_id` from a `haystack_ai_search` hit (or `haystack_create_page`). Do not parse Haystack URLs for ids. Supported types: `knowledge_page`, `post`, `event`, `glossary_term`, and `link`. `person`, `team`, and `file` are not fetchable: files remain available via the signed `url` from search, and people/teams have no long-form body. `body` is TipTap HTML for pages/posts/events, definition text for glossary terms, and empty for links. For links, `url` and `content_url` are the off-site HTTP(S) target when a safe URL is stored, otherwise empty (links have no in-Haystack detail page). When presenting the entity, render `display_title` as a markdown link to `url` if `url` is present.

haystack_get_entity