Funkcje AI monday.com pozwalają wysyłać prompty do modeli AI hostowanych przez monday.com bez konieczności zarządzania własnym dostawcą modeli ani kluczami API. Mutacja run_prompt to uproszczony punkt dostępu natywny dla GraphQL do bramki AI monday.com: wyślij prompt, opcjonalnie dostosuj model i ustawienia generowania, a wygenerowany tekst otrzymasz w tej samej odpowiedzi co pozostałe dane z integracji.

Wymagania

Zanim użyjesz run_prompt, upewnij się, że spełnione są następujące warunki:

• Uprawnienie dostępu do zewnętrznej bramki AI musi być włączone dla konta. Bez niego mutacja zwróci błąd uprawnień.
• Aplikacje: jeśli wywołujesz run_prompt z poziomu aplikacji (za pomocą tokenu aplikacji), aplikacja musi zażądać zakresu AI:Consume.
• Zużycie tokenów AI: podobnie jak w przypadku Models API, korzystanie z funkcji zużywa tokeny monday AI. Obowiązują te same zasady naliczania i zużycia. Szczegóły znajdziesz w sekcji Cennik i naliczanie.

Mutacje

Wymagany zakres (aplikacje): AI:Consume

Uruchom prompt

Wysyła pojedynczy prompt do modelu AI hostowanego przez monday.com i zwraca wygenerowany tekst. Zwraca obiekt RunPromptResult.

mutation {
  run_prompt(
    prompt: "Summarize the benefits of regular exercise in two sentences."
    config: {
      model: MONDAY_STANDARD
      system_prompt: "You are a concise assistant."
      temperature: 0.7
      max_tokens: 200
    }
  ) {
    content
  }
}

Minimalna postać wymaga tylko pola prompt:

mutation {
  run_prompt(prompt: "Say hello in exactly three words.") {
    content
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `
  mutation {
    run_prompt(
      prompt: "Summarize the benefits of regular exercise in two sentences."
      config: { model: MONDAY_STANDARD, temperature: 0.7, max_tokens: 200 }
    ) {
      content
    }
  }
`;
const response = await mondayApiClient.request(query);

Argumenty

Pola