Премини към основното съдържание
Български— Изберете език
Меню

След Agent Builder: Agents SDK, Workspace Agents и Agents API

Урок 3 от 25 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Какво се затваря, какво остава
  2. Път 1: Agents SDK, за изграждане чрез код
  3. Път 2: ChatGPT Workspace Agents
  4. Път 3: Agents API, когато OpenAI оркестрира вместо Вас
  5. Как да изберете
  6. Ключови изводи

Досега този урок разгледа Agent Builder – визуалния инструмент на OpenAI без код за създаване на агенти. OpenAI обяви края на жизнения му цикъл на 3 юни 2026 г., като пълното спиране е планирано за 30 ноември 2026 г. Вместо да изучавате инструмент, който изчезва, нека разгледаме какво го замества. Имате три пътя в зависимост от целите си: писане на код, изграждане на естествен език за екип или предаване на оркестрацията на OpenAI.

Какво се затваря, какво остава

Agent Builder се затваря; ChatKit, интерфейсният компонент, който ще видите по-късно в този курс, остава достъпен. Ако вече имате работен поток в Agent Builder, OpenAI Ви позволява да го експортирате преди спирането: отворете работния поток, изберете Code в горната лента, след това Agents SDK, изберете TypeScript или Python и копирайте целия експорт. Ръководството за миграция честно предупреждава, че този експорт не конвертира графа на работния поток и не гарантира, че всяко поведение ще бъде възпроизведено точно: планирайте фаза на тестване.

Път 1: Agents SDK, за изграждане чрез код

Това е пътят, който този курс следва, започвайки от следващия урок. Agents SDK Ви осигурява пълен контрол: Вие декларирате агента, неговите инструкции, модел и инструменти във Вашето приложение, стартирате го във Ваша собствена среда и го внедрявате като останалата част от кода си. Експортът от Agent Builder се включва директно в него; след това инсталирате съответния SDK, конфигурирате приложението и валидирате поведението преди внедряване.

from agents import Agent, Runner, WebSearchTool

agent = Agent(
    name="Technical Support",
    instructions=(
        "You are a technical support agent for a SaaS company. "
        "Respond in English. Identify the problem before proposing solutions."
    ),
    model="gpt-6.1-sol",
    tools=[WebSearchTool()],
)

result = Runner.run_sync(agent, "My CSV export has been empty since this morning.")
print(result.final_output)

Път 2: ChatGPT Workspace Agents

Ако сте използвали Agent Builder, за да избегнете кодирането, еквивалентът сега се намира в ChatGPT. Workspace agents се създават на естествен език и се споделят с екип; те изискват план ChatGPT Business, Enterprise или Edu, достъп до workspace agents и разрешение за тяхното създаване. За миграция OpenAI предлага прост метод: създайте нов агент в ChatGPT и поставете експорта на работния си поток с подкана „help me convert this workflow into an agent“. Преди финализиране прегледайте генерираните инструкции, конфигурирайте необходимите приложения, умения, автентикации и разрешения, след което използвайте Preview, за да възпроизведете случаи, представителни за оригиналния работен поток. Едно ограничение, което трябва да отбележите: работен поток, чиято основа разчита на строго детерминирана последователност, може да не се преведе верно в агент.

Път 3: Agents API, когато OpenAI оркестрира вместо Вас

От 10 септември 2026 г. съществува трети път в публична бета версия: Agents API. Той предоставя на Вашето приложение достъп до инфраструктурата Codex чрез API, управляван от OpenAI. Вашето приложение осигурява инструментите и избира средата за изпълнение; OpenAI се грижи за сесиите, оркестрацията, компресирането на контекста и възстановяването от инциденти. Агентът може да работи в пясъчник (sandbox), където изпълнява код, модифицира файлове, се свързва със сървъри MCP и произвежда документи.

API се върти около четири концепции: агент (модел, инструкции, инструменти и сървъри MCP), среда (пясъчник или компютър, по избор, хостван от OpenAI или от Вас), сессия (устойчив екземпляр на агента, който получава задачи и отговаря на тях) и събития (това, което изпращате, и това, което агентът произвежда). Една сесия се развива в четири етапа: Вие я създавате, възлагате ѝ задача, следите напредъка ѝ чрез поток (stream) или уебхук и след това я рестартирате или пренасочвате по средата на изпълнението.

from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "Answer technical questions precisely, relying on web search.",
        "tools": [{"type": "web_search"}],
    },
    input=[{
        "role": "user",
        "content": [{"type": "input_text", "text": "Summarize the recommended steps to connect an MCP server to an OpenAI agent."}],
    }],
)
print(session.id)

Две ограничения трябва да бъдат проверени, преди да изберете този път за чувствителни данни: Agents API понастоящем предлага резидентност на данните само в Съединените щати и не отговаря на изискванията за нулево запазване на данни, дори с пясъчник, хостван от Вас. Таксуването следва тарифата на API за избрания модел, тарифата за инструменти на OpenAI и тарифата за контейнери за хоствани пясъчници.

Как да изберете

Ако Вашият екип знае как да разработва и иска да запази контрол върху изпълнението, изберете Agents SDK. Ако целта е да предоставите агент на колеги, които не са разработчици, в рамките на ChatGPT, изберете workspace agents. Ако искате агент, който работи за дълги периоди, с изпълнение на код и под-агенти, без да поддържате оркестрацията сами, разгледайте Agents API, като имате предвид неговия бета статус и ограниченията за данни.

Официални източници: Migrate from Agent Builder · Agents API · Deprecations

Ключови изводи

  • Agent Builder се затваря на 30 ноември 2026 г.; ChatKit остава достъпен; експортирайте работните си потоци в код на Agents SDK преди тази дата
  • Agents SDK: изграждайте чрез код и внедрявайте във Вашето приложение – това е пътят за този курс
  • Workspace agents: изграждайте на естествен език в ChatGPT (планове Business, Enterprise, Edu)
  • Agents API (публична бета): OpenAI управлява сесиите, оркестрацията и компресирането; резидентност на данните само в Съединените щати, без нулево запазване на данни