# Projektowanie narzędzi dla agentów

EN: **Designing tools for agents** · id `tooldesign` · aliases: agent-computer interface, ACI, tool design, writing tools for agents, projektowanie narzędzi

Path: [AI Atlas](https://aiatlasgraph.com/llms.txt) › [Aplikacje LLM i agenci](https://aiatlasgraph.com/t/applications.md) › [Narzędzia i integracje](https://aiatlasgraph.com/t/tools.md) › Projektowanie narzędzi dla agentów

## Description

- PL: Praktyki projektowania nazw, opisów, parametrów, odpowiedzi i błędów narzędzi pod kątem modeli, weryfikowane ewaluacjami na realnych zadaniach.
- EN: Practices for designing tool names, descriptions, parameters, responses and errors for models, verified with evaluations on realistic tasks.

## In one sentence

- PL: Sztuka przygotowania funkcji tak, żeby model od razu rozumiał, do czego służą, jak ich użyć i co zrobić z wynikiem.
- EN: The craft of shaping functions so a model immediately understands what they are for, how to use them and what to do with the result.

## Problem it solves

- PL: Asystent myli podobne funkcje, podaje złe dane i grzęźnie w zbyt długich wynikach, choć sam model jest dobry.
- EN: An assistant mixes up similar functions, passes wrong data and drowns in overly long results even though the model itself is good.

## What it does

- PL: Jak dobra instrukcja dla nowego pracownika: jasne nazwy, przykłady i komunikaty błędów, które mówią, co poprawić.
- EN: Like a good briefing for a new hire: clear names, examples and error messages that say what to fix.

## Everyday example

- PL: Zamiast trzech funkcji „znajdź klienta”, „pobierz zamówienia” i „pobierz notatki” asystent dostaje jedną, która zwraca cały kontekst klienta.
- EN: Instead of three functions to find a customer, get orders and get notes, the assistant gets one that returns the customer's whole context.

## This concerns you if you…

- PL: udostępniasz asystentowi własne funkcje lub serwer narzędzi
- PL: agent często wybiera złe narzędzie lub podaje złe dane
- PL: wyniki twoich narzędzi zapychają kontekst
- EN: expose your own functions or tool server to an assistant
- EN: see an agent often pick the wrong tool or arguments
- EN: find your tool results clogging the context

## Keywords

agent-computer interface · tool descriptions · tool namespacing · response_format · pagination · actionable error messages · input_examples · tool evaluation

## How it works

- PL: Zamiast opakowywać każdy endpoint API buduje się kilka narzędzi pod wysokowartościowe przepływy, z prefiksami przestrzeni nazw i jednoznacznymi parametrami. Odpowiedzi zwracają treści czytelne dla modelu zamiast surowych identyfikatorów, z paginacją, filtrami i trybem zwięzłym. Opisy i przykłady wywołań poprawia się iteracyjnie na podstawie transkryptów ewaluacji.
- EN: Rather than wrapping every API endpoint, a few tools target high-value workflows, with namespace prefixes and unambiguous parameters. Responses return model-readable content instead of raw identifiers, with pagination, filters and a concise mode. Descriptions and example calls are refined iteratively from evaluation transcripts.

## Limits

- PL: To, co działa dla jednego modelu, nie musi działać dla innego, więc projekt wymaga testów przy zmianie modelu. Ewaluacje narzędzi kosztują czas i tokeny, a dopasowanie do zbyt wąskiego zestawu zadań grozi przeuczeniem opisów.
- EN: What works for one model may not work for another, so designs need retesting when models change. Tool evaluations cost time and tokens, and tuning to too narrow a task set risks overfitting descriptions.

## Key terms

- PL: **przestrzeń nazw narzędzi**: Wspólny prefiks grupujący narzędzia jednej usługi lub zasobu.
- PL: **agent–computer interface**: Interfejs komend i odpowiedzi zaprojektowany pod model, nie pod człowieka.
- PL: **przykłady wywołań**: Wzorcowe wywołania pokazujące konwencje, których schemat nie opisuje.
- EN: **tool namespacing**: A shared prefix grouping one service's or resource's tools.
- EN: **agent-computer interface**: Commands and responses designed for a model rather than a person.
- EN: **tool use examples**: Sample calls showing conventions a schema does not express.

## Know first

- [Structured outputs i walidacja (Structured outputs and validation)](https://aiatlasgraph.com/t/structured.md)
- [Budowa polecenia: instrukcje, rola i znaczniki (Prompt structure: instructions, roles and delimiters)](https://aiatlasgraph.com/t/promptstructure.md)

## Related topics

Untyped, symmetric "see also" links.

- [Dostrajanie do wywoływania funkcji i narzędzi (Function-calling and tool-use fine-tuning)](https://aiatlasgraph.com/t/toolcallingft.md)

## Sources

- [Writing effective tools for agents — with agents](<https://www.anthropic.com/engineering/writing-tools-for-agents>) `anthropic-writing-tools-2025` · by Anthropic Engineering
- [Introducing advanced tool use on the Claude Developer Platform](<https://www.anthropic.com/engineering/advanced-tool-use>) `anthropic-advanced-tool-use-2025` · by Anthropic Engineering

---

AI Atlas revision 124 (2026-10-31) · HTML: https://aiatlasgraph.com/t/tooldesign · index: https://aiatlasgraph.com/llms.txt · everything: https://aiatlasgraph.com/llms-full.txt · updated 2026-10-31