Artykuły są częścią funkcji Baza wiedzy w monday.com. Dzięki nim zespoły mogą tworzyć artykuły z wiedzą i udostępniać je w obszarach roboczych, aby dokumentacja była uporządkowana i łatwa do znalezienia.

---

Zapytania

Pobieranie artykułów

Zwraca opublikowane artykuły dla podanych identyfikatorów obiektów. Każdy artykuł zawiera obiekt metadata i tablicę blocks (pierwszą stronę bloków treści; użyj article_blocks, aby pobrać więcej).

• Wymagany zakres uprawnień: docs:read
• Zwraca [Article]!
• Można wykonać zapytanie tylko na głównym poziomie - nie można zagnieździć go w innym polu

query {
  articles(
    object_ids: [1234567890]
    workspace_ids: [9876543210]
    limit: 25
    page: 1
  ) {
    metadata {
      object_id
      name
      state
    }
    blocks {
      id
    }
  }
}

Argumenty

Argument	Typ	Opis
object_ids	[ID!]!	Wymagane. Identyfikatory obiektów artykułów (na przykład z adresu URL artykułu).
workspace_ids	[ID!]	Opcjonalne. Ogranicza wyniki do tych obszarów roboczych.
limit	Int	Maksymalna liczba artykułów na stronę. Wartość domyślna: 25.
page	Int	Numer strony (numerowanie od 1). Wartość domyślna: 1.

---

Pobieranie bloków artykułu

Zwraca stronicowane bloki treści opublikowanej wersji pojedynczego artykułu, jeśli użytkownik wykonujący zapytanie ma do niego dostęp.

• Wymagany zakres uprawnień: docs:read
• Zwraca [ArticleBlock]!
• Można wykonać zapytanie tylko na głównym poziomie - nie można zagnieździć go w innym polu

query {
  article_blocks(object_id: "1234567890", limit: 25, page: 1) {
    id
  }
}

Argumenty

Argument	Typ	Opis
object_id	ID!	Identyfikator obiektu artykułu.
limit	Int	Maksymalna liczba bloków na stronę. Wartość domyślna: 25.
page	Int	Numer strony (numerowanie od 1). Wartość domyślna: 1.

---

Wyszukiwanie w bazie wiedzy

Wyszukuje informacje w bazie wiedzy z użyciem AI. Zwraca odpowiedź wygenerowaną przez LLM oraz fragmenty źródeł, na których się opiera.

• Wymagany zakres uprawnień: docs:read
• Zwraca KnowledgeBaseAnswer
• Można wykonać zapytanie tylko na głównym poziomie - nie można zagnieździć go w innym polu

query {
  knowledge_base_search(query: "How do I reset a password?", limit: 5) {
    answer
    raw_snippets {
      id
      title
      text
      url
    }
  }
}

Argumenty

Argument	Typ	Opis
query	String!	Tekst wyszukiwania w języku naturalnym.
limit	Int	Maksymalna liczba uwzględnianych fragmentów. Wartość domyślna: 5.

Pola (KnowledgeBaseAnswer)

Pole	Typ	Opis
answer	String	Odpowiedź wygenerowana przez model.
raw_snippets	[SnippetSearchResult]	Pasujące fragmenty źródeł użyte do wygenerowania odpowiedzi.

---

Mutacje

Wymagany zakres uprawnień: docs:write

Tworzenie artykułu

Tworzy nowy artykuł w bazie wiedzy jako wersję roboczą. Zwraca ArticleMetadata.

mutation {
  create_article(
    name: "Getting started"
    workspace_id: "1234567890"
    folder_id: "9876543210"
  ) {
    object_id
    name
    workspace_id
  }
}

Argumenty

Argument	Typ	Opis
name	String	Opcjonalna nazwa wyświetlana artykułu.
workspace_id	ID!	Obszar roboczy, w którym zostanie utworzony artykuł.
folder_id	ID	Opcjonalny folder, w którym zostanie umieszczony artykuł.

---

Publikowanie artykułu

Publikuje wersję roboczą artykułu i ustawia jego widoczność oraz obserwujących. Argumenty dodawania i usuwania obserwujących mają zastosowanie, gdy privacy_kind ma wartość PRIVATE. Zwraca ArticleMetadata.

mutation {
  publish_article(
    object_id: "1234567890"
    privacy_kind: PUBLIC
    folder_id: "9876543210"
    add_subscriber_ids: [111, 222]
    add_subscriber_team_ids: [333]
    remove_subscriber_ids: []
    remove_subscriber_team_ids: []
  ) {
    object_id
    privacy_kind
    state
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
object_id	ID!	Identyfikator obiektu artykułu.
privacy_kind	PrivacyKind!	Określa, czy artykuł jest widoczny tylko dla obserwujących, czy dla wszystkich osób w obszarze roboczym.	PRIVATE, PUBLIC
folder_id	ID	Opcjonalny folder dla opublikowanego artykułu.
add_subscriber_ids	[ID!]	Identyfikatory użytkowników, których należy dodać jako obserwujących (artykuły prywatne).
add_subscriber_team_ids	[ID!]	Identyfikatory zespołów, które należy dodać jako grupy obserwujących (artykuły prywatne).
remove_subscriber_ids	[ID!]	Identyfikatory użytkowników, których należy usunąć z listy obserwujących.
remove_subscriber_team_ids	[ID!]	Identyfikatory zespołów, które należy usunąć z listy obserwujących.

---

Usuwanie artykułu

Usuwa artykuł na podstawie identyfikatora obiektu. Zwraca ArticleMetadata.

mutation {
  delete_article(object_id: "1234567890") {
    object_id
    state
  }
}

Argumenty

Argument	Typ	Opis
object_id	ID!	Artykuł do usunięcia.