---

Kolumna AI pozwala automatyzować analizę tekstu, kategoryzowanie, tłumaczenie i inne zadania z użyciem AI. Każda kolumna jest skonfigurowana z określonym typem bloku AI, który decyduje o tym, co robi AI i z których kolumn źródłowych pobiera dane.

Za pomocą API możesz skonfigurować blok AI w dowolnej kompatybilnej kolumnie lub usunąć konfigurację AI z kolumny.

Mutacje

Wymagany zakres: boards:write

configure_categorize_ai_column

Przypisuje elementowi etykietę lub kategorię na podstawie analizy treści. AI wybiera etykietę spośród istniejących etykiet w kolumnie docelowej. Zwraca AiColumnResult.

mutation {
  configure_categorize_ai_column(
    board_id: "1234567890"
    column_id: "status_col"
    source_type: item_name
    additional_instructions: "Use only: Urgent, Normal, Low"
    extra_settings: { run_backfill: true }
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu status lub dropdown.
source_type	AiColumnSourceType!	Źródło danych wejściowych dla AI.	item_name thread column emails_and_activities
source_column_id	String	Wymagane, gdy source_type ma wartość column. Kolumna, z której AI ma pobierać dane wejściowe.
additional_instructions	String	Niestandardowe reguły kategoryzowania. Maksymalnie 5000 znaków.
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_summarize_ai_column

Tworzy zwięzłe podsumowanie tekstu wejściowego. Zwraca AiColumnResult.

mutation {
  configure_summarize_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    source_type: thread
    additional_instructions: "3 bullet points max"
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu text lub long_text.
source_type	AiColumnSourceType!	Źródło danych wejściowych dla AI.	item_name thread column
source_column_id	String	Wymagane, gdy source_type ma wartość column. Kolumna, z której AI ma pobierać dane wejściowe.
additional_instructions	String	Wymagania dotyczące formatu lub obszary, na których AI ma się skupić. Maksymalnie 5000 znaków.
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_translate_ai_column

Tłumaczy tekst na wybrany język. Zwraca AiColumnResult.

mutation {
  configure_translate_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    source_type: item_name
    target_language: spanish
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu text lub long_text.
source_type	AiColumnSourceType!	Źródło danych wejściowych dla AI.	item_name column
source_column_id	String	Wymagane, gdy source_type ma wartość column. Kolumna, z której AI ma pobierać dane wejściowe.
target_language	AiColumnLanguage!	Język, na który ma zostać przetłumaczony tekst. Zobacz AiColumnLanguage, aby poznać obsługiwane wartości.
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_improve_text_ai_column

Przepisuje lub poprawia tekst, aby zwiększyć jego jakość. Zwraca AiColumnResult.

mutation {
  configure_improve_text_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    source_type: column
    source_column_id: "long_text_col"
    tone: professional
    length: shorter
    refinement_type: minimal_changes
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu text lub long_text.
source_type	AiColumnSourceType!	Źródło danych wejściowych dla AI.	item_name column
source_column_id	String	Wymagane, gdy source_type ma wartość column. Kolumna, z której AI ma pobierać dane wejściowe.
tone	AiColumnTone	Styl pisania. Zobacz AiColumnTone, aby poznać obsługiwane wartości.
length	AiColumnImproverLength	Długość wyniku w porównaniu z tekstem wejściowym.	same shorter longer
refinement_type	AiColumnRefinementLevel	Rodzaj poprawy.	minimal_changes moderate_changes high_creativity
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_extract_ai_column

Wyodrębnia z tekstu uporządkowane informacje. Zwraca AiColumnResult.

mutation {
  configure_extract_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    source_type: column
    source_column_id: "long_text_col"
    entity_type: email_address
  ) {
    column_id
  }
}

mutation {
  configure_extract_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    source_type: item_name
    entity_type: custom
    custom_instructions: "the invoice number"
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu text, long_text, date, email, phone lub link.
source_type	AiColumnSourceType!	Źródło danych wejściowych dla AI.	item_name thread column
source_column_id	String	Wymagane, gdy source_type ma wartość column. Kolumna, z której AI ma pobierać dane wejściowe.
entity_type	AiColumnEntityType!	Typ informacji do wyodrębnienia. Użyj custom z parametrem custom_instructions, aby wyodrębnić dowolne informacje. Zobacz AiColumnEntityType, aby poznać wszystkie wartości.
custom_instructions	String	Wymagane, gdy entity_type ma wartość custom. Określa, co należy wyodrębnić. Maksymalnie 5000 znaków.
additional_instructions	String	Dodatkowe informacje kontekstowe, np. „szefa”. Maksymalnie 5000 znaków.
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_open_block_ai_column

Elastyczny blok ogólnego zastosowania, który sprawdza się przy złożonych lub niestandardowych promptach. Odwołania do kolumn źródłowych umieszcza się bezpośrednio w ai_query, używając składni {pulse.column_id}. Zwraca AiColumnResult.

mutation {
  configure_open_block_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    ai_query: "Analyze {pulse.description_col} and rate complexity from 1-5"
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu text, long_text, numbers, date, status lub dropdown.
ai_query	String!	Instrukcja napisana językiem naturalnym. Odwołuj się do kolumn tablicy za pomocą {pulse.column_id}, do nazwy elementu za pomocą {pulse.name} lub do kolumn podelementów za pomocą {pulse.subitem.column_id}. Maksymalnie 3000 znaków.
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_write_me_ai_column

Tworzy nowy tekst na podstawie promptu. Odwołania do kolumn źródłowych umieszcza się bezpośrednio w ai_query, używając składni {pulse.column_id}. Zwraca AiColumnResult.

mutation {
  configure_write_me_ai_column(
    board_id: "1234567890"
    column_id: "text_col"
    ai_query: "Write a professional follow-up email about {pulse.name}"
    tone: professional
    length: paragraph
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu text, long_text lub doc.
ai_query	String!	Prompt określający, jaką treść wygenerować. Odwołuj się do kolumn tablicy za pomocą {pulse.column_id}, do nazwy elementu za pomocą {pulse.name} lub do kolumn podelementów za pomocą {pulse.subitem.column_id}. Maksymalnie 3000 znaków.
tone	AiColumnTone!	Ton lub styl wypowiedzi. Zobacz AiColumnTone, aby poznać obsługiwane wartości.
length	AiColumnOutputLength!	Przybliżona oczekiwana długość wyniku.	sentence paragraph brief in_depth
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

configure_person_assignment_ai_column

Przypisuje osobę do elementu na podstawie reguł lub kontekstu. Zwraca AiColumnResult.

mutation {
  configure_person_assignment_ai_column(
    board_id: "1234567890"
    column_id: "person_col"
    source_type: thread
    groups: "[{\"id\": 1, \"name\": \"Alice\"}, {\"id\": 2, \"name\": \"Bob\"}]"
  ) {
    column_id
  }
}

Argumenty

Argument	Typ	Opis	Wartości enuma
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, którą chcesz skonfigurować z użyciem AI. Musi to być kolumna typu people.
source_type	AiColumnSourceType!	Źródło danych wejściowych dla AI.	item_name thread column
source_column_id	String	Wymagane, gdy source_type ma wartość column. Kolumna, z której AI ma pobierać dane wejściowe.
groups	String!	Tablica dostępnych osób lub zespołów zapisana jako ciąg JSON, np. [{"id": 1, "name": "Alice"}].
extra_settings	AiColumnExtraSettingsInput	Określa, czy zastosować automatyzację AI do istniejących elementów.

---

remove_ai_from_column

Usuwa całą konfigurację AI z kolumny. Zwraca AiColumnRemoveResult.

mutation {
  remove_ai_from_column(
    board_id: "1234567890"
    column_id: "text_col"
  ) {
    column_id
    success
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Tablica zawierająca kolumnę.
column_id	String!	Kolumna, z której chcesz usunąć konfigurację AI.

---

Inne typy

AiColumnResult

Zwracany przez wszystkie mutacje configure_*_ai_column.

Pole	Typ	Opis
column_id	String!	Skonfigurowana kolumna.

AiColumnRemoveResult

Zwracany przez remove_ai_from_column.

Pole	Typ	Opis
column_id	String!	Kolumna, z której usunięto konfigurację AI.
success	Boolean!	Zawsze true - błędy powodują zwrócenie błędu GraphQL.

AiColumnExtraSettingsInput

Pole	Typ	Opis
run_backfill	Boolean	Określa, czy od razu zastosować automatyzację AI do istniejących elementów. Gdy ma wartość true, przetwarzanych jest maksymalnie 200 elementów. Domyślnie ma wartość true.

AiColumnSourceType

Wartość enuma	Opis
item_name	Używa nazwy elementu jako danych wejściowych.
thread	Używa wątku aktualizacji elementu jako danych wejściowych.
column	Używa wartości wskazanej kolumny źródłowej. Wymaga parametru source_column_id.
emails_and_activities	Używa wiadomości e-mail i danych o aktywności jako danych wejściowych.

AiColumnTone

Używany przez configure_improve_text_ai_column i configure_write_me_ai_column.

Wartość enuma	Opis
empathic	Ciepły i wyrozumiały.
promotional	Przekonujący, skoncentrowany na marketingu.
confident	Stanowczy i zdecydowany.
professional	Formalny, odpowiedni do komunikacji biznesowej.
natural	Konwersacyjny i niewymuszony.
casual	Swobodny i nieformalny.
friendly	Przystępny i ciepły.
same	Zachowuje oryginalny ton.

AiColumnOutputLength

Używany przez configure_write_me_ai_column.

Wartość enuma	Opis
sentence	Jedno zdanie.
paragraph	Krótki akapit.
brief	Krótki przegląd.
in_depth	Szczegółowa, dłuższa treść.

AiColumnLanguage

Używany przez configure_translate_ai_column. Obsługiwane wartości: english, spanish, french, german, hebrew, chinese, korean, arabic, bengali, danish, dutch, hindi, indonesian, italian, japanese, norwegian, polish, portuguese, russian, swedish, thai, turkish, vietnamese.

AiColumnEntityType

Używany przez configure_extract_ai_column.

Wartość enuma	Opis
email_address	Adres e-mail.
first_name	Imię osoby.
last_name	Nazwisko osoby.
phone_number	Numer telefonu.
company_name	Nazwa firmy.
domain_name	Domena lub witryna internetowa.
url	Adres URL.
date	Data.
time	Godzina.
year	Rok.
custom	Niestandardowy typ informacji określony przez custom_instructions.

---

Kody błędów

Nieprawidłowe dane wejściowe są odrzucane. Zwracany błąd GraphQL zawiera konkretny kod w extensions.

Kod	Znaczenie
INVALID_COLUMN_ID	column_id nie istnieje na tablicy.
INVALID_COLUMN_TYPE	Typ kolumny wskazanej przez column_id nie jest zgodny z blokiem.
INVALID_SOURCE_COLUMN_ID	source_column_id nie istnieje na tablicy.
SELF_REFERENCING_COLUMN	source_column_id ma tę samą wartość co column_id.
UNSUPPORTED_SOURCE_COLUMN_TYPE	Typ kolumny źródłowej nie jest obsługiwany przez ten blok.
INVALID_COLUMN_REFERENCE	Odwołanie {pulse.column_id} w ai_query wskazuje nieistniejącą lub nieobsługiwaną kolumnę.
EMPTY_QUERY_FIELDS	ai_query nie zawiera odwołań do kolumn z danymi.
QUERY_TOO_LONG	ai_query przekracza 3000 znaków.
INSTRUCTIONS_TOO_LONG	additional_instructions lub custom_instructions przekracza 5000 znaków.
INVALID_SOURCE_TYPE	Wartość source_type nie należy do zbioru wartości dozwolonych dla tego bloku.
MISSING_SOURCE_COLUMN_ID	source_type ma wartość column, ale nie podano source_column_id.
MISSING_CUSTOM_INSTRUCTIONS	entity_type ma wartość custom, ale nie podano custom_instructions.

Przykładowa odpowiedź z błędem:

{
  "errors": [
    {
      "message": "Column \"text_col\" is of type \"text\", which is not supported as a target for categorize. Allowed types: status, dropdown",
      "extensions": {
        "code": "INVALID_COLUMN_TYPE"
      }
    }
  ]
}