Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

SDK Anatomija: Agentas, Vykdytojas, Įrankis, Apsauga

Paskaita 5 iš 25 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. SDK Anatomija: Agentas, Vykdytojas, Įrankis, Apsauga
  2. Agentas: Konfigūracija
  3. Vykdytojas: Vykdymas
  4. Įrankis: Galimybės
  5. Apsauga: Saugumas
  6. Kaip šios dalys sąveikauja
  7. Svarbiausi punktai

SDK Anatomija: Agentas, Vykdytojas, Įrankis, Apsauga

Agents SDK grindžiamas keturiomis pagrindinėmis sąvokomis: Agentu, Vykdytoju (Runner), Įrankiu ir Apsauga (Guardrail). Kiekvienas jų turi vieną atsakomybę. Būtent jų sąveika – kas sprendžia, kas vykdo, kas veikia, kas kontroliuoja – daro SDK suprantamą, kai tai įsisavini.

1

Agentas – Smegenys

Apibrėžia instrukcijas, modelį, įrankius ir apsaugos taisykles. Tai tavo agento konfigūracija.

2

Vykdytojas – Vykdymo variklis

Valdo samprotavimo ciklą: siunčia užklausas, vykdo įrankius ir tvarko perdavimus.

3

Įrankis – Galimybės

Funkcijos, kurias agentas gali iškviesti: paieška internete, kodo vykdymas, API užklausos ir kt.

4

Apsauga – Saugumas

Tikrina agento įvestis ir išvestis. Blokuoja pavojingas arba netinkamas užklausas.

Agentas: Konfigūracija

Agent klasė yra grynai deklaratyvi: ji nieko nevykdo, tik aprašo. Viskas, kas apibrėžia tavo agento elgseną, yra vienoje vietoje.

from agents import Agent, function_tool, WebSearchTool

@function_tool
def get_price(product: str) -> str:
    """Retrieves the price of a product."""
    prices = {"widget": "€29.99", "gadget": "€49.99"}
    return prices.get(product, "Unknown product")

agent = Agent(
    name="Sales Agent",
    instructions="""You are a sales agent for an online store.
    Help customers find products and learn their prices.
    Always respond in French with a professional tone.""",
    model="gpt-5.6-terra",
    tools=[get_price, WebSearchTool()],
    handoff_description="Agent specialized in selling products",
    output_type=None,  # or a Pydantic type to enforce an output format
)

Pagrindiniai Agent parametrai:

  • name: Žmogui suprantamas agento identifikatorius
  • instructions: Sistemos promptas, apibrėžiantis elgseną
  • model: Naudojamas modelis (gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna)
  • tools: Galimų įrankių sąrašas
  • handoff_description: Aprašymas, naudojamas perduodant užduotis tarp agentų
  • output_type: Pydantic tipas išvesties formatui struktūrizuoti

Vykdytojas: Vykdymas

Runner yra variklis, kuris vykdo tavo agentą. Jis valdo visą ciklą ir turi tris veikimo režimus, priklausomai nuo kvietimo konteksto.

from agents import Runner

# Sinchroninis režimas (kūrimas)
result = Runner.run_sync(agent, "What is the price of the widget?")

# Asinchroninis režimas (gamyba)
result = await Runner.run(agent, "What is the price of the widget?")

# Srautinis režimas (realiuoju laiku)
result = Runner.run_streamed(agent, "What is the price of the widget?")

Nepriklausomai nuo režimo, gauni RunResult, kuriame yra daug daugiau nei tik rodomas atsakymas. Pilna istorija leidžia tęsti pokalbį, o last_agent tampa esminis, kai keli agentai perduoda užduotis vienas kitam.

result = Runner.run_sync(agent, "What is the price of the widget?")

# Galutinis agento atsakymas
print(result.final_output)

# Pilna pokalbio istorija
print(result.to_input_list())

# Paskutinis aktyvus agentas (naudinga perduodant užduotis)
print(result.last_agent.name)

Įrankis: Galimybės

SDK palaiko tris būdus deklaruoti įrankius – nuo dažniausiai naudojamo iki labiausiai architektūriško.

1. Funkciniai įrankiai (dažniausiai)

Dekoruoji Python funkciją ir ji tampa įrankiu; SDK automatiškai nuspėja schemą iš funkcijos parašo ir dokumentacijos eilutės (docstring).

from agents import function_tool

@function_tool
def send_email(recipient: str, subject: str, body: str) -> str:
    """Sends an email to a recipient."""
    # Your sending logic here
    return f"Email sent to {recipient}"

2. OpenAI talpinami įrankiai

Šie įrankiai vykdomi OpenAI pusėje: tau nereikia rašyti paieškos logikos ar Python smėlio dėžės kodo.

from agents import WebSearchTool, FileSearchTool, CodeInterpreterTool

tools = [
    WebSearchTool(),                               # Web search
    FileSearchTool(vector_store_ids=["vs_123"]),   # File search
    CodeInterpreterTool(tool_config={"type": "code_interpreter", "container": {"type": "auto"}}),                          # Code execution
]

3. Agentai kaip įrankiai

Vienas agentas gali naudoti kitą kaip įrankį. Toliau pateiktas koordinatorius deleguoja tyrimą niekada neperleisdamas pokalbio kontrolės, ir tai skiria šį būdą nuo užduoties perdavimo (handoff).

search_agent = Agent(
    name="Researcher",
    instructions="You look up precise information.",
    tools=[WebSearchTool()],
)

primary_agent = Agent(
    name="Coordinator",
    instructions="You coordinate research.",
    tools=[search_agent.as_tool(
        tool_name="search",
        tool_description="Performs in-depth research"
    )],
)

Apsauga: Saugumas

Apsauga (guardrail) yra kontrolinis agentas, pastatytas prieš tavo verslo agentą. Čia tikrintojas patikrina, ar užklausa susijusi su pardavimais, prieš tai, kai pardavimų agentas atsako.

from agents import Agent, InputGuardrail, GuardrailFunctionOutput, Runner

guardrail_agent = Agent(
    name="Verifier",
    instructions="Determine whether the request concerns sales. Respond true or false.",
    output_type=bool,
)

async def verify_topic(ctx, agent, input_data):
    result = await Runner.run(guardrail_agent, input_data, context=ctx)
    return GuardrailFunctionOutput(
        output_info=result.final_output,
        tripwire_triggered=not result.final_output,
    )

protected_agent = Agent(
    name="Protected Sales Agent",
    instructions="You are a sales agent.",
    input_guardrails=[
        InputGuardrail(guardrail_function=verify_topic),
    ],
)

Jei apsauga suveikia (tripwire_triggered=True), vykdymas sustabdomas ir išmetama InputGuardrailTripwireTriggered išimtis. Suplanuok ją sugauti savo programoje; priešingu atveju vartotojui, kuris tiesiog uždavė netinkamą klausimą, grąžinsi 500 klaidą.

Kaip šios dalys sąveikauja

Visas procesas vyksta taip:

  1. Tu kvieti Runner.run(agent, message)
  2. Vykdytojas patikrina įvesties apsaugos taisykles
  3. Vykdytojas siunčia žinutę agento modeliui
  4. Jei modelis prašo įrankio, Vykdytojas jį vykdo
  5. Vykdytojas grąžina rezultatą modeliui (grįžtama prie 3 žingsnio)
  6. Kai modelis sukuria galutinį atsakymą, Vykdytojas patikrina išvesties apsaugos taisykles
  7. Grąžinamas RunResult

Svarbiausi punktai

  • Agent apibrėžia elgseną (instrukcijos, modelis, įrankiai)
  • Runner organizuoja agento ciklo vykdymą
  • Įrankius deklaruok naudodamas @function_tool, integruotas klases arba .as_tool()
  • Apsaugos taisyklės tikrina įvestis ir išvestis saugumui užtikrinti
  • RunResult saugo galutinį atsakymą ir visą istoriją