
GPT-6.2 API, OpenAI'ın ajan işleri için güncel tercihi: API değişiklik günlüğü gpt-6.2-sol'u "günlük kodlama ve ajan iş akışları için", gpt-6.2-astra'yı ise "zorlu akıl yürütme ve kodlama görevleri için" öneriyor. Bu kılavuz, iki modelden birini PoYo'nun Responses uç noktası üzerinden bir kodlama ajanına bağlıyor: fonksiyon araçları, sınırlı bir döngü, akışla gelen ilerleme bilgisi, büyük bir depo bağlamı ve uzun oturumları uygun maliyetli tutan önbellek. GPT-6.2 Sol model sayfasından başlayın, GPT-6.2 Astra'yı yükseltme için saklayın.
Henüz ilk isteğinizi göndermediyseniz GPT-6.2 API kılavuzuyla başlayın.
API bir kodlama ajanına ne sağlıyor
| Öğe | PoYo'da GPT-6.2 |
|---|---|
| Model kimlikleri | gpt-6.2-sol (varsayılan), gpt-6.2-astra (yükseltme) |
| Ajan uç noktası | POST https://api.poyo.ai/v1/responses (OpenAI SDK, base_url="https://api.poyo.ai/v1") |
| Araç çağırma | Yalnızca Responses; OpenAI: "araç çağırma için Responses gerekir" |
| Bağlam / maks. girdi / maks. çıktı | 1,050,000 / 922,000 / 128,000 token |
| Akış | "stream": true; response.completed son çıktıyı ve usage bilgisini taşır |
| Akıl yürütme | reasoning.effort; none reddedilir, medium ile başlayın |
| 1M başına fiyat (Sol) | $1.60 girdi / $8 çıktı / $0.08 önbellek okuma / $2 önbellek yazma |
| 1M başına fiyat (Astra) | $6.40 girdi / $32 çıktı / $0.32 önbellek okuma / $8 önbellek yazma |
| Hatalar | 400 geçersiz alanlar, 401 hatalı anahtar, 402 yetersiz kredi, 404 bilinmeyen model; 429 / 5xx için geri çekilmeyle yeniden deneyin |
PoYo'nun Responses referansı tools, tool_choice, parallel_tool_calls, reasoning, include, store, previous_response_id ve truncation alanlarını belgeler ve araç desteğinin modele bağlı olduğunu belirtir. OpenAI'ın model sayfaları GPT-6.2 için fonksiyon çağırmayı ve bir dizi barındırılan aracı listeliyor. PoYo belgeleri barındırılan araç örneği olarak yalnızca web_search_preview gösteriyor; bu yüzden bu ajan, uçtan uca sizin kontrolünüzde olan kendi fonksiyon araçlarınızı kullanır.
Fonksiyon araçlarını tanımlayın
Araç kümesini küçük ve güvenli tutun. Model yalnızca sizin uyguladığınız eylemleri isteyebilir:
import json, os, subprocess
from pathlib import Path
from openai import OpenAI
client = OpenAI(base_url="https://api.poyo.ai/v1", api_key=os.environ["POYO_API_KEY"])
REPO = Path("/srv/checkout").resolve()
TOOLS = [
{"type": "function", "name": "read_file",
"description": "Read a UTF-8 text file from the repository.",
"parameters": {"type": "object", "properties": {"path": {"type": "string"}},
"required": ["path"], "additionalProperties": False}},
{"type": "function", "name": "write_file",
"description": "Replace a file in the repository with new content.",
"parameters": {"type": "object",
"properties": {"path": {"type": "string"}, "content": {"type": "string"}},
"required": ["path", "content"], "additionalProperties": False}},
{"type": "function", "name": "run_tests",
"description": "Run the test suite and return the last 200 lines of output.",
"parameters": {"type": "object", "properties": {}, "additionalProperties": False}},
]
def safe_path(p: str) -> Path:
full = (REPO / p).resolve()
if not full.is_relative_to(REPO):
raise ValueError("path escapes the repository")
return full
def call_tool(name: str, args: dict) -> str:
try:
if name == "read_file":
return safe_path(args["path"]).read_text(encoding="utf-8")[:200_000]
if name == "write_file":
safe_path(args["path"]).write_text(args["content"], encoding="utf-8")
return "ok"
if name == "run_tests":
r = subprocess.run(["pytest", "-q"], cwd=REPO, capture_output=True, text=True, timeout=600)
return "\n".join((r.stdout + r.stderr).splitlines()[-200:])
return f"unknown tool {name}"
except Exception as e: # return errors to the model instead of crashing the loop
return f"error: {e}"
Ajanı her zaman tek kullanımlık bir checkout veya container üzerinde çalıştırın, asla kendi çalışma ağacınızda değil.
Sınırlı bir ajan döngüsü
Döngü konuşmayı gönderir, her function_call öğesini yürütür, aynı call_id ile bir function_call_output ekler ve model araç çağrısı yapmadan yanıt verene kadar tekrarlar. Bir tur sınırında ve bir dolar bütçesinde durur.
PRICES = {"gpt-6.2-sol": (1.60, 8.00, 0.08, 2.00), "gpt-6.2-astra": (6.40, 32.00, 0.32, 8.00)}
def cost(model, u) -> float:
p_in, p_out, p_read, p_write = PRICES[model]
d = getattr(u, "input_tokens_details", None)
read = getattr(d, "cached_tokens", 0) or 0
write = getattr(d, "cache_write_tokens", 0) or 0
return ((u.input_tokens - read - write) * p_in + read * p_read
+ write * p_write + u.output_tokens * p_out) / 1e6
DEVELOPER = ("You are a coding agent working in a Python repository. "
"Read files before editing. Run the tests after every change. "
"When the tests pass, reply with a short summary and no tool call.")
def run_agent(task: str, model="gpt-6.2-sol", max_turns=30, budget_usd=3.00):
items = [{"role": "developer", "content": DEVELOPER},
{"role": "user", "content": task}]
spent = 0.0
for turn in range(max_turns):
resp = client.responses.create(
model=model, input=items, tools=TOOLS,
reasoning={"effort": "medium"}, max_output_tokens=16000,
store=False, include=["reasoning.encrypted_content"],
)
spent += cost(model, resp.usage)
items += [o.model_dump(exclude_none=True) for o in resp.output]
calls = [o for o in resp.output if o.type == "function_call"]
if not calls:
return resp.output_text, spent, turn + 1
for c in calls:
items.append({"type": "function_call_output", "call_id": c.call_id,
"output": call_tool(c.name, json.loads(c.arguments))})
if spent >= budget_usd:
break
raise RuntimeError(f"stopped after {turn + 1} turns, ${spent:.3f} spent")
Döngünün neden böyle kurulduğu:
- Akıl yürütme öğeleri dahil çıktı öğeleri sırasıyla geri gönderilir. Zero Data Retention'da olduğu gibi
storedeğerinin false olduğu isteklerde OpenAI'ın GPT-6.2 kılavuzu "önceki çıktı öğelerini, şifrelenmiş akıl yürütme öğeleri dahil, sırasıyla geri gönderin" diyor.include=["reasoning.encrypted_content"]bunları talep eder. Alternatif, PoYo'nun da belgelediği, saklanan yanıtlarlaprevious_response_idkullanmaktır. - Geçmiş yalnızca eklemeyle büyür. OpenAI, konuşma ortasındaki düzenlemelerin Responses API'nin akıl yürütme öğelerini düşürmesine yol açabileceği konusunda uyarıyor; bu da "yanıt kalitesini düşürebilir ve token kullanımını artırabilir". Ayrıca bir düzenleme önbelleğe alınmış öneki de bozar.
- Bütçe her turda kontrol edilir, faturayla aynı fiyat tablosu kullanılarak.
Bu yazı için bu döngünün tam olarak aynısını PoYo üzerinde uçtan uca çalıştırmadık. Önce küçük bir görevde çalıştırın ve araç çağrılarının ve usage değerlerinin beklendiği gibi göründüğünü doğrulayın.
İlerlemeyi kullanıcıya akışla iletmek
Uzun ajan turları geri bildirim olmadan yavaş hissettirir. Her turu akışla alın, metin parçalarını gösterin ve son çıktıyı response.completed olayından alın. PoYo'nun belgelediği olay türleri şunlardır:
def stream_turn(model, items):
final = None
with client.responses.create(model=model, input=items, tools=TOOLS,
reasoning={"effort": "medium"}, max_output_tokens=16000,
store=False, include=["reasoning.encrypted_content"],
stream=True) as stream:
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
final = event.response
elif event.type == "response.failed":
raise RuntimeError(event.response)
return final # same object as the non-streaming call: .output, .usage
Döngüde responses.create yerine stream_turn kullanın. Araç çağrıları, önceden olduğu gibi final.output içinden okunur.
Uzun bağlam: 922K girdi, 128K çıktı
GPT-6.2, istek başına en fazla 922,000 girdi token'ı kabul eder. Bir ajan, dosyaları tek tek okumak yerine bir deponun büyük bir bölümünü baştan yükleyebilir. Bu tercihi üç sınır belirler:
- Her tur geçmişi yeniden gönderir. 20 tur boyunca 200K token'lık bir anlık görüntü en az 4M girdi token'ı demektir. Sol'un $1.60 ücretiyle bu, önbelleksiz $6.40 eder. Anlık görüntünün bir kez önbelleğe yazılması ($0.40) ve $0.08 ücretle 19 önbellek okumasıyla ($0.30) yaklaşık $0.70 olur.
- OpenAI'ın uzun bağlam katmanı 272K girdi token'ının üzerinde başlar. OpenAI'ın fiyatlandırma sayfası bu sınırın ötesinde tüm istek için girdi ve önbellek ücretlerini iki katına çıkarır ve çıktı için 1.5× ücret alır. Görev daha fazlasını gerektirmedikçe ajan isteklerini 272K'nın altında tutun ve geçerli PoYo ücreti için model sayfasını kontrol edin.
- Akıl yürütme çıktı bütçesini paylaşır.
max_output_tokens, görünür metni ve akıl yürütmeyi birlikte sınırlar. Tüm depoyu yeniden yazdırmak yerine herwrite_fileçağrısında tek bir dosya isteyin.
Araç çıktısını eklemeden önce kırpın: bir test çalıştırmasının 20,000 satırını değil, son 200 satırını döndürün. Bu, tur başına büyümeyi ve faturayı doğrusal ve küçük tutar.
Ajan oturumlarında istem önbelleği
OpenAI'ın önbellek kılavuzu GPT-6.2 için şu kuralları koyar:
| Kural | Değer |
|---|---|
| Önbellek okuma fiyatı | Girdinin 0.05× katı (PoYo'da 1M başına Sol'da $0.08, Astra'da $0.32) |
| Önbellek yazma fiyatı | Varsayılan 30 dakikalık saklama için girdinin 1.25× katı (PoYo'da 1M başına $2 / $8) |
| Önbelleğe alınabilir minimum önek | 1,024 görünür girdi token'ı |
| Örtük kesme noktası | Uygun son mesajın sonu |
| Kullanım alanları | usage.input_tokens_details.cached_tokens (okumalar), cache_write_tokens (yazmalar) |
Önbellek isabetlerini olası kılmak için:
- Sabit içeriği başa koyun. Developer mesajı, ardından araç tanımları, ardından depo anlık görüntüsü, ardından görev.
- Üst düzey
instructionsyerine birdevelopermesajı kullanın. GPT-6.2,instructionsalanınıinput'tan sonra ekler; bu yüzden önekin dışında kalırlar. - Önceki öğeleri asla düzenlemeyin. Araç çıktılarını ekleyin; geçmişi yeniden yazmayın.
- Bir oturum içinde ayarları sabit tutun. OpenAI'ın kılavuzu, yanıtlar arasında ayar değiştirdiğinizde öneki değiştirmeden tutmanızı söylüyor.
OpenAI ayrıca prompt_cache_options alanını (açık kesme noktaları ve 12 saatlik saklama) belgeliyor. PoYo'nun Responses şeması bu alanı listelemiyor ve ek alanlara kapalı olarak tanımlanmış (additionalProperties: false); bu yüzden onu dışarıda bırakın ve örtük önbelleğe güvenin. Sol'da en iyi durumdaki 25 turluk bir oturum, önbelleksiz $3.82'den yaklaşık $0.74'e iner; hesap GPT-6.2 API fiyatlandırması yazısında.
Çalıştırma ne zaman Astra'ya devredilmeli
Her çalıştırmaya gpt-6.2-sol ile başlayın. Tur sınırında başarısız testlerle durursa görevi yeni bir öğe listesiyle gpt-6.2-astra üzerinde yeniden başlatın. Aynı konuşma içinde modeli değiştirmeyin, çünkü OpenAI model değişikliklerinin akıl yürütme öğelerini düşürebileceğini söylüyor. Yönlendirme hesabı ve bir yönlendirici GPT-6.2 Sol API ve GPT-6.2 Astra API yazısında. Aynı döngünün başka bir sağlayıcıdaki karşılığı için kodlama ajanları için Gemini 4 Carbon API yazısıyla karşılaştırın.
Sıkça sorulan sorular
GPT-6.2 API fonksiyon çağırmayı destekliyor mu?
Evet, /v1/responses üzerinde. Araçları type: "function" ile tanımlayın, function_call öğelerini output içinden okuyun ve sonuçları aynı call_id ile function_call_output öğeleri olarak geri gönderin.
GPT-6.2 API araçlarını Chat Completions ile kullanabilir miyim?
Hayır. OpenAI, GPT-6.2'nin Chat Completions'ı desteklediğini, ancak araç çağırmanın Responses gerektirdiğini söylüyor.
Bir GPT-6.2 API ajan turunu nasıl akışla alırım?
Responses'ta stream: true ayarlayın, response.output_text.delta olaylarını yazdırın ve araç çağrılarını ve usage bilgisini response.completed olayından okuyun.
Uzun ajan oturumlarında GPT-6.2 API maliyetlerini nasıl düşürürüm?
Başta sabit bir önek (developer mesajı, araçlar, anlık görüntü) tutun, düzenlemek yerine ekleyin, araç çıktısını kırpın ve mümkün olduğunda istek başına 272K girdi token'ının altında kalın.
Kodlama ajanımı hangi GPT-6.2 modeli çalıştırmalı?
Token başına Astra'nın dörtte biri tutan gpt-6.2-sol ile başlayın ve başarısız bir çalıştırmayı gpt-6.2-astra üzerinde yeniden başlatın.