MCP: przykłady pracy

Połącz asystenta zgodnie z instrukcją MCP. Zacznij od pandrator_get_system_status i pandrator_get_capabilities. Sprawdź schematy udostępniane przez serwer. Przykłady opisują kontrakt wersji 0.13.0; zapisanych wielkimi literami identyfikatorów nie da się wkleić bez zmian.

Każdemu nowemu żądaniu nadaj osobny klucz idempotencji. Gdy po niepewnej odpowiedzi ponawiasz to samo żądanie, zachowaj klucz i wszystkie argumenty. Odczytuj zwrócone numery wersji oraz identyfikatory zamiast zgadywać kolejne wartości.

Przygotowanie audiobooka w Pandratorze

Przykład zakłada skonfigurowaną usługę mowy i plik tekstowy UTF-8 w zatwierdzonym katalogu źródeł. Zastąp wartości zapisane wielkimi literami danymi zwróconymi przez poprzednie wywołania.

pandrator_create_session(name="Krótka narracja", idempotency_key="book-create-1")
pandrator_import_local_source(session_id=SESSION_ID, root="books", relative_path="excerpt.txt", expected_session_revision=SESSION_REVISION, idempotency_key="book-import-1")
pandrator_prepare_speech_plan(session_id=SESSION_ID, expected_revision=CURRENT_REVISION, source_artifact_id=SOURCE_ARTIFACT_ID, idempotency_key="book-plan-1")

Jeśli import zwróci identyfikator zadania, poczekaj na zakończenie pracy i sprawdź wyodrębniony tekst, zanim przygotujesz plan. Po imporcie odczytaj aktualny numer wersji projektu. Przeczytaj bloki planu, przypisania głosów, tekst i ostrzeżenia. Rozwiąż problemy przed oznaczeniem konkretnej wersji jako sprawdzonej. Nie oznaczaj nieprzeczytanego planu tylko po to, by odblokować generowanie.

pandrator_review_speech_plan(session_id=SESSION_ID, revision_id=PLAN_REVISION_ID, content_signature=INSPECTED_SIGNATURE, idempotency_key="book-review-1")
pandrator_generate_speech_plan(session_id=SESSION_ID, speech_plan_revision_id=PLAN_REVISION_ID, settings_source="current", idempotency_key="book-generate-1")
pandrator_get_generation_operation(operation_id=OPERATION_ID, wait_seconds=30)

Odczytuj stan tej samej operacji aż do zakończenia. Sprawdź wybraną generację i gotowe pliki. Połącz nagrania z właściwej generacji, zweryfikuj eksport i wywołaj pandrator_download_artifact ze zwróconym identyfikatorem pliku. Odpowiedź punktu kontroli stanu usługi nie jest wynikiem generowania.

Korekta wykonywana przez asystenta

Tryb pasywnego przetwarzania pozwala połączonemu asystentowi poprawić ograniczone partie tekstu bez konfigurowania w Pandratorze dodatkowej usługi modelu językowego. Utwórz zadanie korekty dla wybranego źródła, a następnie pobierz partię do opracowania.

pandrator_create_dispatch_run(session_id=SESSION_ID, kind="correction", source_artifact_id=SOURCE_ARTIFACT_ID, idempotency_key="correct-create-1")
pandrator_claim_dispatch_batch(run_id=RUN_ID, idempotency_key="correct-claim-1")

Przeczytaj partię i wprowadzaj tylko uzgodnione zmiany. Do przesłania wyniku użyj identyfikatora partii i jej tokenu dzierżawy. Identyfikatory fragmentów cue_ids muszą pochodzić z tej partii.

{"batch_id":"BATCH_ID","lease_token":"LEASE_TOKEN","idempotency_key":"correct-submit-1","result":{"kind":"correction","operations":[{"action":"edit","cue_ids":["CUE_ID"],"texts":["Tekst po sprawdzonej korekcie."]}]}}

Przekaż obiekt do pandrator_submit_dispatch_batch. Podaj wynik typowany albo starsze pole z tekstem odpowiedzi, nigdy oba naraz. W pandrator_get_dispatch_run(run_id=RUN_ID) sprawdzisz pozostałe partie i końcowy plik. Dzierżawa domyślnie trwa 900 sekund. Można ją odnowić lub zwolnić. Po wygaśnięciu pobierz partię ponownie z nowym kluczem żądania i użyj nowego tokenu; nie twórz drugiego zadania korekty.

Jeśli po przesłaniu partii nie udało się utworzyć pliku końcowego, ponów wyłącznie identyczne przesłanie z tym samym kluczem idempotencji, o ile pozwala na to zwrócony stan. Nie zakładaj, że każde zadanie zakończone błędem da się wznowić. Kieruj się wskazanym następnym krokiem i opisem trybu pasywnego.

Pliki i uprawnienia

Asystent widzi zatwierdzone nazwy katalogów i ścieżki względne. Nie daje mu to dostępu do dowolnych plików. Ścieżki z ../ i wychodzące poza wskazany katalog są odrzucane. Import próbek audio przez MCP ma limit 16 MiB. Pobierane pliki trafiają do skonfigurowanego katalogu wynikowego. Odczyt, zmiany ustawień, wykonywanie i anulowanie zadań wymagają osobnych uprawnień. Naprawa przez Managera wymaga dodatkowego upoważnienia.