Plik AGENTS.md dla agentów

AGENTS.md to zwykły plik tekstowy w głównym folderze projektu, który agenty AI czytają przed rozpoczęciem pracy. Jantaris udostępnia gotową wersję pod adresem https://jantaris.com/agents.md. Po wrzuceniu jej do repozytorium agent wie, jak uwierzytelnić się kluczem, jak zlecić obraz albo wideo przez POST /v1/generate, jak odpytać zadanie, jak rozmawiać z modelami czatu i jak podłączyć serwer MCP. Nie musisz mu niczego tłumaczyć.

Co jest w pliku

• base URL https://jantaris.com/v1 i nagłówek Authorization: Bearer $JANTARIS_API_KEY,
• zasady kosztów: blokada przed startem, nieudana generacja za 0, kody 402 i 403,
• katalog modeli (GET /v1/models, GET /v1/models/{id}) i zasada "przeczytaj schemat, zanim wyślesz input",
• przykłady curl: obraz, wideo z odpytywaniem, piosenka z tekstem, czat,
• webhooki z podpisem,
• konfiguracja serwera MCP dla Claude Code, Codex CLI i Cursora,
• tabela błędów i ostrzeżenie, że POST /v1/generate nie jest idempotentny.

Plik jest po angielsku, bo tak najlepiej czytają go agenty. Odpowiadać będą w języku, w którym do nich piszesz.

Pobranie do repozytorium

Otwórz terminal w głównym folderze projektu.

macOS i Linux

curl -fsSL https://jantaris.com/agents.md -o AGENTS.md

Masz już własny AGENTS.md? Dopisz opis Jantarisa na końcu zamiast nadpisywać:

curl -fsSL https://jantaris.com/agents.md >> AGENTS.md

Windows PowerShell

Invoke-WebRequest -Uri "https://jantaris.com/agents.md" -OutFile "AGENTS.md"

Dopisanie do istniejącego pliku:

Invoke-RestMethod -Uri "https://jantaris.com/agents.md" | Add-Content -Path "AGENTS.md" -Encoding utf8

Bez terminala

Otwórz https://jantaris.com/agents.md w przeglądarce, zaznacz całość (Ctrl+A), skopiuj i wklej do nowego pliku AGENTS.md w folderze projektu.

Sprawdzenie

head -5 AGENTS.md

Get-Content AGENTS.md -TotalCount 5

Pierwsza linia to # AGENTS.md - Jantaris API. Potem zapytaj agenta: "Jak według AGENTS.md wygenerować obraz przez Jantaris?". Jeśli odpowie z POST /v1/generate i ?wait=60, plik działa.

Które narzędzia go czytają

Dla Claude Code najprościej:

echo "@AGENTS.md" >> CLAUDE.md

Add-Content -Path "CLAUDE.md" -Value "@AGENTS.md"

Klucz zostaje poza repozytorium

Plik nie zawiera klucza. Agent czyta go ze zmiennej środowiskowej JANTARIS_API_KEY, którą ustawiasz raz:

export JANTARIS_API_KEY="sk-jt-..."

[Environment]::SetEnvironmentVariable("JANTARIS_API_KEY", "sk-jt-...", "User")

Klucz tworzysz w panelu, zakładka Klucze API. Ustaw mu Limit miesięczny - agent z dostępem do generowania wideo powinien mieć twardy sufit wydatków.

Jeśli trzymasz klucz w pliku .env, upewnij się, że .env jest w .gitignore.

Własne zasady pod spodem

Pod opisem API dopisz zasady dla swojego projektu, np.:

## Zasady projektu

- Przed każdą generacją wideo podaj koszt (estimated_cost) i poczekaj na moją zgodę.
- Obrazy zapisuj w public/img/ jako .webp.
- Do obrazów używaj nano-banana-pro, do wideo seedance-2.5 w 720p.
- Nie generuj więcej niż 3 warianty naraz.

Aktualizacja

Gdy dodamy nowe endpointy albo zmienimy przykłady, wystarczy pobrać plik ponownie poleceniem z sekcji wyżej. Jeśli dopisałeś własne zasady, trzymaj je w osobnej sekcji i po pobraniu wklej z powrotem albo przenieś do osobnego pliku.

Najczęstsze problemy