Codex i YouTube: wyjaśnij API w krótkim filmie

Codex dla YouTube

Krótka demonstracja jednego wywołania API może dotrzeć do programistów, którzy nie zajrzeliby do dokumentacji. Każdy film wymaga jednak scenariusza, nagrania i przesłania pliku, choć zespół opisał już działanie w przykładzie kodu. Codex może przeczytać ten przykład, uruchomić go i przygotować objaśnienie zgodne z rzeczywistym wynikiem. Prześledźmy pracę osoby odpowiedzialnej za relacje z programistami w firmie oferującej API: dlaczego warto sprawdzić kod przed nagraniem, jak powstaje szkic oraz które zadania pozostają po jej stronie — nagranie, kontrola i zatwierdzenie.

Przykład: API płatności wyjaśnia klucze idempotencji

Firma płatnicza opisuje w dziesięciu liniach kodu, jak klucz idempotencji zapobiega podwójnemu obciążeniu. Osoba odpowiedzialna za relacje z programistami prosi Codex o przeczytanie przykładu i uruchomienie go w środowisku testowym. Codex potwierdza, że drugie wywołanie zwraca ten sam wynik, i pisze 45-sekundowy scenariusz: problem podwójnego obciążenia, rozwiązanie w jednej linii i wynik na ekranie. Proponuje trzy tytuły krótsze niż 100 znaków. Osoba nagrywa terminal i dodaje film do biblioteki Tareno. Codex znajduje go przez list_media i zapisuje szkic za pomocą create_drafts. Prośba o czwartek o 14:00 w strefie Europe/Dublin pozostaje oczekującym działaniem do czasu zatwierdzenia.

Krok po kroku

1. 01

   Połącz Codex z Tareno

   Dodaj Tareno jako zdalny serwer MCP w wierszu poleceń Codex i zaloguj się przez OAuth zgodnie z instrukcją na stronie Codex. Konfiguracja ChatGPT nie przenosi się automatycznie, więc połączenie trzeba ustawić osobno.

2. 02

   Wskaż przykład kodu

   Podaj plik dokumentacji lub fragment kodu. Poproś Codex o uruchomienie go w środowisku testowym i przedstawienie wyniku każdego wywołania. Scenariusz oparty na niedziałającym kodzie może podważyć zaufanie odbiorców.

3. 03

   Dopasuj scenariusz do obrazu

   Poproś o tekst do wypowiedzenia w około 45 sekund, który krok po kroku śledzi wynik w terminalu. Porównaj każde zdanie z rzeczywistym wynikiem, aby narracja odpowiadała temu, co widać na nagraniu.

4. 04

   Nagraj demonstrację samodzielnie

   Codex nie potrafi nagrywać. Przygotuj pionowy film o długości do 60 sekund, sprawdź, czy nie widać kluczy ani identyfikatorów kont, i dodaj plik do biblioteki multimediów Tareno.

5. 05

   Zapisz szkic

   Codex znajduje film za pomocą list_media i zapisuje tytuł oraz plik jako szkic dla Twojego kanału przez create_drafts. Obejrzyj nagranie razem ze scenariuszem w Tareno przed wskazaniem terminu.

6. 06

   Poproś o termin i zatwierdź

   Podaj datę, godzinę i strefę czasową IANA. Prośba staje się działaniem oczekującym na Twoje zatwierdzenie w panelu. Codex może następnie sprawdzić jego stan przez get_action_status i przekazać wynik.

Prompty do skopiowania

Przeczytaj docs/idempotency.md i uruchom przykład z bloku kodu w środowisku testowym. Podaj dokładnie wynik każdego wywołania i wskaż wszystkie różnice między opisanym zachowaniem a rzeczywistym rezultatem, zanim nagram demonstrację. Jeśli wykonanie się nie powiedzie, wyjaśnij błąd i nie zakładaj, że przykład działa.

Napisz scenariusz mówiony na około 45 sekund do pionowego nagrania ekranu: problem podwójnego obciążenia, rozwiązanie w jednej linii i widoczny wynik. Dopasuj każde zdanie do linii wyniku w terminalu oraz zaproponuj trzy tytuły o długości najwyżej 100 znaków każdy, abym mógł porównać tekst z obrazem.

Znajdź przez Tareno plik [idempotency-demo.mp4] w mojej bibliotece multimediów i zapisz go jako szkic YouTube dla [nazwa kanału] z tytułem [2]. Powiedz, czy film przekracza 60 sekund lub nie jest pionowy. Nie planuj publikacji, dopóki sam nie sprawdzę nagrania i tekstu.

Poproś Tareno o zaplanowanie szkicu [ID szkicu] na [czwartek o 14:00] w strefie [Europe/Dublin]. Zwróć identyfikator oczekującego działania i wyjaśnij, że Short nie zostanie zaplanowany, dopóki nie zatwierdzę go w panelu Tareno. Pokaż datę, godzinę i konto do sprawdzenia.

Błędy, których należy unikać

• Nagrywanie przykładu bez wcześniejszego uruchomienia: jeśli wywołanie zawiedzie na ekranie, Short może przypominać zgłoszenie błędu zamiast wiarygodnej demonstracji.
• Mówienie szybciej niż pojawia się wynik terminala: dopasuj scenariusz do czasu wykonania i sprawdź obraz razem z narracją.
• Używanie prawdziwego klucza w demonstracji: użyj klucza testowego, wymień go później i upewnij się, że nie jest widoczny na nagraniu.
• Wyjaśnianie trzech funkcji w 45 sekund: do tego Shorta wystarczy jedno wywołanie, jeden wynik i zdanie opisujące kontekst.