Krótkie wprowadzenie: korzystanie z interfejsu Developer Knowledge API

Z tego przewodnika dowiesz się, jak zacząć korzystać z Developer Knowledge API. Dowiesz się, jak włączyć Developer Knowledge API, uzyskać klucz interfejsu API i wykonać pierwsze wywołania interfejsu API, aby wyszukać i pobrać dokumentację dla deweloperów.

Zanim zaczniesz

Zanim zaczniesz korzystać z Developer Knowledge API, wykonaj te czynności.

Włącz API

  1. Otwórz stronę Developer Knowledge API w bibliotece interfejsów API Google.
  2. Sprawdź, czy masz wybrany prawidłowy projekt, w którym chcesz używać interfejsu API.
  3. Kliknij Włącz. Do włączenia lub korzystania z interfejsu API nie są wymagane żadne konkretne role IAM.

Tworzenie i zabezpieczanie klucza interfejsu API

  1. W konsoli Google Cloud w projekcie, w którym został włączony interfejs API, otwórz stronę Dane logowania.
  2. Kliknij Utwórz dane logowania, a potem w menu wybierz Klucz interfejsu API.
  3. W polu Nazwa podaj nazwę klucza.

  4. Kliknij menu Wybierz ograniczenia interfejsu API, a potem wpisz Developer Knowledge API. Kliknij wynik, a potem OK.

    Uwagi:

    • Jeśli Developer Knowledge API zostało włączone dopiero co, może minąć trochę czasu zanim pojawi się na liście. Poczekaj kilka minut i spróbuj ponownie.
    • Jeśli planujesz używać tego samego klucza do ogólnych wywołań modelu klienta AI (np. GEMINI_API_KEY), musisz też wybrać Generative Language API. W przeciwnym razie te wywołania zostaną zablokowane.
  5. Kliknij Utwórz.

Generowanie odpowiedzi na podstawie dokumentacji

Gdy masz już klucz Developer Knowledge API, możesz zacząć korzystać z interfejsu API. Ten przykład pokazuje, jak zadać zapytanie i wygenerować odpowiedź na podstawie dokumentacji:

  1. Zapisz klucz interfejsu API Developer Knowledge API w zmiennej środowiskowej:

    export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"

    Zastąp YOUR_API_KEY wygenerowanym kluczem interfejsu API.

  2. Użyj curl, aby wywołać punkt końcowy AnswerQuery:

    curl -X POST "https://developerknowledge.googleapis.com/v1:answerQuery?key=$DEVELOPERKNOWLEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I create a BigQuery dataset?"}'

To polecenie zwraca odpowiedź na zapytanie na podstawie dokumentacji.

Wyszukiwanie fragmentów dokumentów

Jeśli chcesz znaleźć konkretne fragmenty dokumentacji, a nie wygenerowaną odpowiedź, możesz bezpośrednio wyszukać fragmenty dokumentów.

Użyj curl, aby wywołać punkt końcowy SearchDocumentChunks:

curl "https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks?query=BigQuery&key=$DEVELOPERKNOWLEDGE_API_KEY"

Odpowiedź zawiera pasujące fragmenty treści z dokumentacji i odniesienia do dokumentów nadrzędnych.

Pobieranie dokumentu

Odpowiedź z searchDocumentChunks zawiera listę fragmentów dokumentów. Każdy fragment dokumentu ma pole parent zawierające nazwę zasobu dokumentu, którego można użyć z GetDocument, aby pobrać pełną zawartość dokumentu.

Aby pobrać dokument, skopiuj pole parent z jednego z fragmentów zwróconych przez searchDocumentChunks, zapisz je w zmiennej środowiskowej, a potem użyj curl, aby wywołać punkt końcowy GetDocument:

export DOC_NAME="PARENT_FIELD_FROM_SEARCH"

curl "https://developerknowledge.googleapis.com/v1/$DOC_NAME?key=$DEVELOPERKNOWLEDGE_API_KEY"

Spowoduje to zwrócenie pełnej zawartości dokumentu w formacie Markdown.

Co dalej?