2026年Agentic AI工程师完整路线图（英文）

CompleteRoadmaptoBecomeanAgenticAIEngineer

in2026

InterviewQuestions&AnswersbyTopic

LamhotSiagian

PhDStudent•AIEvaluationEngineer•AIEngineer

MachineLearning•DataScience&AI/ML

/in/lamhotsiagian

lamhotsiagian2025@

January19,2026

Thisdocumentturnsthe2026AgenticAIlearningroadmapintopracticalinterviewpractice.Eachsection

includes10commoninterviewquestionswithmodelanswersandafewsmallcodeexamples.

AgenticAIEngineerRoadmap(2026)InterviewQ&A

i

Contents

1HowtoUseThisRoadmap

1

2PythonFundamentals(forAgenticAI)

2

3LLMFundamentals

4

4PickaFramework(LangChain/LangGraphvsCrewAIvsAutoGen)

6

5AdvancedFrameworkConcepts(LCEL,Runnables,Workflows,Multi-Agent)

8

6MemoryManagement(Short-Term,Long-Term,Checkpointing)

10

7ToolIntegration(CustomTools,Connectors,Decorators)

12

8RAGSystems(VectorStores,Embeddings,RetrievalStrategies)

14

9Agents&Multi-Agents(ReAct,Supervisors,Communication)

16

10BuildReal-WorldProjects(FastAPI,Streamlit/UI,Docker,AWS)

18

11QuickChecklist:TheRightOrdertoLearn(2026)

20

AgenticAIEngineerRoadmap(2026)InterviewQ&A

1

1HowtoUseThisRoadmap

Thisroadmapfollowsa“foundation-first”order:learncoreprogramming,thenLLMconcepts,thenframeworks,thenadvancedagentarchitecture,thenproductiondeployment.

Howtopractice:foreachtopic,(1)readthequestions,(2)rewriteanswersinyourownwords,(3)implementatleastonesmallprojectpersection,and(4)keepnotesoffailuresandfixes—thatiswhatinterviewerswanttohear.

Scope:ThequestionsfocusonAgenticAIengineeringforsoftwareproducts:tool-usingLLMapps,multi-agentworkflows,RAG,memory,evaluation,anddeployment.

AgenticAIEngineerRoadmap(2026)InterviewQ&A

2

2PythonFundamentals(forAgenticAI)

1.1Question:WhyisPythonthedefaultlanguageforAgenticAIengineering?

Answer:PythonhasamatureecosystemforAPIs,dataprocessing,andML(e.g.,FastAPI,Pydantic,NumPy,PyTorch)andexcellentdeveloperergonomics.Mostagentframeworksandtooling(LangChain/LangGraph,CrewAI,AutoGen,vectorDBclients)providefirst-classPythonsupport.Ininterviews,emphasizethatPythonletsyourapidlyprototypeandthenhardensystemswithtyping,tests,andpackaging.

1.2Question:ExplainhowyouwouldstructureaPythonprojectforanagenticsystem.

Answer:Usealayeredstructure:app/(API/UIentrypoints),core/(domainlogic,prompts,policies),agents/(agentgraphs,routers),tools/(toolwrappers,schemas),rag/(chunking,retrieval),eval/(tests,goldensets),andinfra/(Docker,configs).Addpyproject.toml,typedinterfaces,andunit/integrationtests.Thegoalisseparationsofconcernssoprompts/toolscanevolvewithoutbreakingdeployment.

1.3Question:WhatPythonfeaturesmattermostforbuildingrobustagents?

Answer:Typehints(mypy/pyright),dataclassesorPydanticmodelsforschemas,contextmanagersforresourcesafety,async/awaitforIO-heavytoolcalls,andexceptionsforexpliciterrorhandling.OOPisusefulfortooladapters,butcompositionandsmallpurefunctionsoftenscalebetter.Alsoimportant:logging,retries/backoff,anddependencyinjectionfortestability.

1.4Question:HowdoyoudesignacleanAPIclientfortools(REST/GraphQL)?

Answer:Definerequest/responsemodels(Pydantic),centralizeauthandbaseURL,implementtimeouts,retries,andidempotencywherepossible.Exposesmallmethodsalignedtobusinessactions,notrawendpoints.LogcorrelationIDsfortracingacrossagentsteps.Ininterviews,mentionprotectingsecretswithenvvarsorasecretmanagerandneverprintingtokens.

1.5Question:WhenwouldyouusesynchronousvsasynchronousPythonforagents?

Answer:Iftoolsaremostlynetworkcalls(search,DB,externalAPIs),asynccanimprovethroughputandlatencybyrunningcallsconcurrently.IfyourworkloadisCPU-bound(embed-dinglargebatcheslocally),multiprocessingorbackgroundworkersmaybebetter.Manyagentappsmixboth:asyncfortoolcalls,andajobqueueforheavypreprocessing/indexing.

1.6Question:ShowaminimalexampleofatypedtoolinputschemainPython.

Answer:Agoodpatternistovalidatetoolinputsbeforetheagentrunsthetool.

frompydanticimportBaseModel,Field

classWeatherArgs(BaseModel):

city:str=Field(...,min_length=2)

units:str=Field("metric",pattern="^(metric|imperial)$")

Typedschemasreducehallucinatedparametersandgiveclearerrorsyoucanroutebacktotheagentforself-repair.

1.7Question:Howdoyoutestagenticcodewhereoutputsareprobabilistic?

Answer:Testdeterministiclayers(parsers,tooladapters,routingrules)withunittests.ForLLMsteps,use“golden”promptswithsnapshots,andevaluatewithmetricslikeexactmatch,

AgenticAIEngineerRoadmap(2026)InterviewQ&A

3

JSONschemavalidity,orrubric-basedscoring.Addintegrationteststhatmocktoolsandcontrolseeds/temperature.Thegoalistodetectregressions,nottoproveperfectcorrectness.

1.8Question:WhatarecommonPythonpitfallsinproductionagentapps?

Answer:Unboundedretriescausingstorms,missingtimeouts,leakingfilehandles/sockets,globalstatesharedacrossrequests,andweakinputvalidation.Anotherpitfallismixingpromptlogicwithbusinesslogicsochangesbecomerisky.Finally,lackingobservability(structuredlogs,traces)makesdebugging“agentwentweird”almostimpossible.

1.9Question:Howdoyoumanageconfigurationacrosslocal/dev/prod?

Answer:Useasingleconfigobjectloadedfromenvvars(andoptionallyaconfigfile),validatedbyPydantic.Keepsecretsoutofsourcecontrol.Versionconfigswithinfrastructure(Terraform/CloudFormation)anddocumentrequiredvariables.Ininterviews,mentionfeatureflagsforsafelyrollingoutnewpromptsoragentpolicies.

1.10Question:ExplaindependencymanagementandreproducibilityinPythonforML/agents.

Answer:Usealockfileapproach(e.g.,uv/poetry/pip-tools)soversionsarepinned.Separateruntimedepsfromdev/testdeps.BuildDockerimageswithpinnedOSpackages.Reproducibil-itymattersbecausesmalllibrarychangescanaltertokenization,

HTTPclients

,orvectorDBbehavior,whichchangesagentoutputs.

AgenticAIEngineerRoadmap(2026)InterviewQ&A

4

3LLMFundamentals

2.1Question:Insimpleterms,howdoesanLLMgeneratetext?

Answer:AnLLMpredictsthenexttokengivenprevioustokens.Itconvertstextintotokens,mapstokenstoembeddings,appliestransformerlayerswithattentiontocomputecontextualrepresentations,andthenproducesaprobabilitydistributionoverthenexttoken.Generationrepeatsuntilastopcondition.Foragents,thekeyisthat“reasoning”ispattern-basedprediction,soyoumustprovidestructure,tools,andconstraints.

2.2Question:Whataretokens,andwhydotheymatterforengineering?

Answer:Tokensarethemodel’sdiscreteunits(oftensubwordpieces).Theyaffectcost,latency,andhowmuchcontextyoucanprovide.Tokenlimitsforcetradeoffs:whatinstructions,memory,andretrieveddocsfit.Engineersoptimizeprompts,retrieval,andsummariestostaywithincontextwhilepreservingtherightevidence.

2.3Question:Explainthecontextwindowanditspracticalimpactonagents.

Answer:Thecontextwindowisthemaximumtokensthemodelcanattendtoatonce.Ifyouexceedit,themodeltruncatesoryoumustsummarize.Practically,agentsneedmemorystrategies(summaries,retrieval,compression)andcarefultooloutputfiltering.Ininterviews,mention“contextbudgeting”andprotectingcriticalsysteminstructionsfrombeingpushedout.

2.4Question:Whatispromptingbeyond“writeagoodprompt”?

Answer:Promptingisinterfacedesign:specifyrole,task,constraints,outputschema,andexamples.Foragents,youalsodefinetool-usepolicies(whentocalltools,howtociteevidence,howtohandleuncertainty).Goodpromptsreduceambiguityandmakefailuremodespredictable.Youshouldalsoversionpromptslikecodeandtestthem.

2.5Question:Describetemperature,top-p,andwhydeterministicsettingsmatter.

Answer:Temperaturecontrolsrandomness;highermeansmorediverseoutputs.Top-p(nucleussampling)restrictstokenchoicestoaprobabilitymass.Forproductionagents,youoftenpreferlowerrandomnessforreliability,especiallywhenproducingJSONormakingtoolcalls.Youmightincreaserandomnessforbrainstormingbutnotforaction-takingflows.

2.6Question:Whatisfunctioncalling(toolcalling),andwhyisituseful?

Answer:Functioncallingletsthemodeloutputastructuredtoolinvocation(name+argu-ments)insteadoffree-formtext.Yoursystemexecutesthetoolandreturnsresultstothemodel.Thismakesagentsmorereliablebecausetoolshandleexactcomputation,retrieval,andsideeffects.Italsoenablesvalidation(schemas)andsaferexecution(allowlists,sandboxes).

2.7Question:HowdoyoupreventpromptinjectionwhenusingtoolsandRAG?

Answer:Treatretrievedtextasuntrusted.Useastrictsystempolicy:neverfollowinstructionsfromdocuments;onlyextractfacts.Separatetooloutputsfromsysteminstructionsandadda“contentprovenance”tag.Validatetoolargumentsandrestricttoolcapabilities.Alsoapplycontentfiltersandallowlistsforsensitiveactions.

2.8Question:Whatishallucination,andhowdoyoureduceitinagentsystems?

Answer:Hallucinationisconfident-soundingtextnotgroundedintruth.Reduceitbyusingtoolsforfactualqueries,RAGwithcitations,constrainedoutputs(schemas),andexplicit

AgenticAIEngineerRoadmap(2026)InterviewQ&A

5

“abstain”rules.Addverificationloops:cross-checksources,runasecond-passcritic,ortestagainstaknowledgebase.Inproduction,measurehallucinationrateswithevaluationsets.

2.9Question:Explainembeddingsandwhytheyenablesemanticretrieval.

Answer:Embeddingsmaptexttovectorswheresemanticsimilaritycorrespondstogeometriccloseness.Thisallowsapproximatenearest-neighborsearchtoretrieverelevantchunksevenifkeywordsdiffer.Engineerschooseembeddingmodelsbasedondomain,language,cost,andvectordimension.Youalsoneedchunkingstrategiessoembeddingsrepresentcoherentmeaning.

2.10Question:WhatarethemainrisksofLLMappsinproduction?

Answer:Reliability(unexpectedoutputs),security(promptinjection,dataleaks),privacy(PIIexposure),cost/latencyspikes,andevaluationdrift.Agentsaddrisksbecausetheycantakeactionsthroughtools.Mitigationsincludepolicylayers,least-privilegetools,auditlogs,offlineevaluation,andstagedrolloutswithmonitoring.

AgenticAIEngineerRoadmap(2026)InterviewQ&A

6

4PickaFramework(LangChain/LangGraphvsCrewAIvsAutoGen)

3.1Question:HowdoyouchoosebetweenLangChain+LangGraph,CrewAI,andAutoGen?

Answer:Startfromrequirements:deterministicworkflowsvsconversationalautonomy,numberofagents,toolcomplexity,andobservabilityneeds.LangGraphisstrongforexplicitstatemachines/graphs,retries,andlong-runningworkflows.CrewAIisopinionatedfor“role-based”multi-agentcollaboration.AutoGenisflexibleforagent-to-agentchatpatterns.Ininterviews,sayyouprototypequicklybutstabilizewithexplicitgraphsandtests.

3.2Question:WhyisLangGraphoftenrecommendedforproductionagents?

Answer:Itmodelsagentbehaviorasagraphwithnodes(steps)andedges(transitions),whichiseasiertoreasonaboutthanimplicitloops.Youcancheckpointstate,enforcepoliciesatboundaries,andaddretries.Thisimprovesdebuggabilityandpreventsrunawayconversations.Italsosupportshuman-in-the-looppatternsmorenaturally.

3.3Question:Whatisthebiggestanti-patternwhenadoptingaframework?

Answer:Copy-pastingdemocodeandtreatingtheframeworkasthearchitecture.Frameworksareimplementationtools;architectureisyourstatemodel,toolboundaries,datacontracts,andsafetyrules.Ifyouskipfundamentals(schemas,errorhandling,evaluation),frameworkswillamplifychaos.Interviewerslovehearing“Istartsmallandhardenlayers.”

3.4Question:Howdoyouhandlevendorlock-inconcerns?

Answer:AbstracttheLLMandembeddingprovidersbehindinterfaces.Avoidembeddingprovider-specificfeaturesunlessneeded.Keepprompts,schemas,andevaluationsetsportable.Ifusingaframework,isolateitinalayersocorebusinesslogicdoesn’tdependonit.Thenyoucanswapframeworksorproviderswithfewerchanges.

3.5Question:Whatdoes“state”meaninanagentgraph?

Answer:Stateisthestructureddatathatflowsthroughsteps:userinput,conversationhistory,retrieveddocuments,toolresults,anddecisions.Goodstatedesignistypedandminimal.Itenablesreproducibility(replayarun),observability(inspecteachfield),andsafety(validatetransitions).Poorstatedesignleadstohiddencouplingandbrittlebehavior.

3.6Question:Explainhowyouwouldimplementarouterthatchoosestools.

Answer:Useapolicy:eitherrules(keywords,intents)oranLLM-basedclassifierconstrainedtoasmalllabelset.Thenvalidatethechosentoolandargumentsagainstschemas.Logdecisionsandconfidence.Arobustpatternis:Router(decide)→ToolExecutor(act)→Verifier(check)beforeresponding.

3.7Question:Howdoframeworkshelpwithoutputstructure(JSON,schemas)?

Answer:Theyprovideparsers,outputconstraints,andutilitiestoenforcestructuredoutputs.Evenwithoutbuilt-inhelpers,youcanwrapoutputswithPydanticvalidation.Ifparsingfails,theframeworkcanroutetoarepairstep.Ininterviews,mentionfail-closedbehavior:ifschemavalidationfails,donotexecuteactions.

3.8Question:Howdoyoudebugagentsinsideaframework?

Answer:Startwithtraces:prompts,toolcalls,inputs/outputs,latency,andtokenusage.Reproducewithafixedseed/temperature.Thenisolatefailure:wasitretrieval,routing,tool

AgenticAIEngineerRoadmap(2026)InterviewQ&A

7

error,orpromptambiguity?Framework-specificdebuggershelp,butthecoreisobservability+replay.

3.9Question:Whatisagoodmigrationpathfromanotebookdemotoproduction?

Answer:Extractcodeintoapackage,addconfigurationmanagement,andwraptheagentbehindanAPI.Introducetypedschemas,errorhandling,retries,andratelimits.Addevaluationharnesseswithasmallgoldendataset.Finallycontainerizeanddeploywithmonitoring.Thisstagedpathprevents“bigrewrite”failures.

3.10Question:Whatisyourdefault“minimalstack”foragenticprototypes?

Answer:Python+FastAPI,asingleagentloop,asmallsetoftoolswithstrictschemas,avectorstore(orevenin-memory)forRAG,andbasictracing/logging.Whenbehaviorstabilizes,movetoanexplicitgraph(LangGraph),addaUI(Streamlit),andimplementevaluations.Thekeyisminimalmovingpartsatfirst.

AgenticAIEngineerRoadmap(2026)InterviewQ&A

8

5AdvancedFrameworkConcepts(LCEL,Runnables,Workflows,Multi-Agent)

4.1Question:WhatisLCELandwhydoengineersuseit?

Answer:LCEL(LangChainExpressionLanguage)composescomponents(prompts,models,parsers,tools)intopipelines.Itencouragesmodularity:youcanswapamodelorparserwithoutrewritingeverything.Italsomakescomplexchainsreadableandtestable.Ininterviews,highlightcompositionandobservabilitybenefits.

4.2Question:Whatare“runnables”conceptually?

Answer:Arunnableisaunitthattakesinput,producesoutput,andcanbecomposedwithotherrunnables.Thinkofitasafunctionalpipelinebuildingblock.Thishelpsyoustandardizeexecution,logging,retries,andconcurrency.EvenoutsideLangChain,thesameideaapplies:uniforminterfacesforsteps.

4.3Question:Howdoyoudesignaworkflowthatincludesretriesandfallbacks?

Answer:Classifyfailures(tooltimeoutvsinvalidargsvsmodelparsingerror).Fortransientfailures,retrywithexponentialbackoff.Forpersistentfailures,fallbacktosimplertoolsoraskaclarifyingquestion.Ingraphs,modelthisexplicitly:erroredge→repairnode→re-try.Logeachattempttoavoidinfiniteloops.

4.4Question:Explain“multi-agent”vs“singleagentwithtools.”

Answer:Singleagentwithtoolsisonedecision-makercallingexternalfunctions.Multi-agentsplitsresponsibilities:e.g.,planner,retriever,executor,critic.Thiscanimprovespecializationandsafetybutincreasescoordinationcomplexity.Interviewerswanttohearthatyouonlygomulti-agentwhenthetasktrulybenefitsfromdecomposition.

4.5Question:Whatisa“workflow”comparedtoa“chain”?

Answer:Achainisusuallylinear:stepAthenBthenC.Aworkflowincludesbranching,loops,humanapprovalsteps,anddifferentpathsfordifferentconditions.Agenticsystemsoftenneedworkflowsbecauserealtaskshaveuncertaintyandpartialfailures.LangGraph-likestatemachinesareanaturalfit.

4.6Question:Howdoyoupreventagentsfromloopingforever?

Answer:Addmaximumsteps,timebudgets,and“stopconditions”basedontaskcompletionsignals.Trackrepeatedtoolcallsorrepeatedreasoningpatterns.Implementawatchdogthatforcesescalation:asktheuser,orreturnpartialresults.Inagraph,enforcetheseviastatecountersandguardedges.

4.7Question:Whatis“structuredoutput”andwhyisitcriticalforagents?

Answer:Structuredoutputmeansthemodelproducesmachine-validateddata(JSONcon-formingtoaschema).Itpreventsbrittlestringparsingandreduceshallucinatedparameters.Italsoenablessafetoolexecution:onlyrunifschemavalidationpasses.Foragenticproducts,structuredoutputisoftenthedifferencebetweenademoandareliablesystem.

4.8Question:Howdoyoudesigna“critic”orverifierstep?

Answer:Defineexplicitcriteria:citationpresent,toolresultsused,JSONvalid,constraintsmet.Usedeterministicchecksfirst(schemavalidation,regex,businessrules).Optionallyadd

AgenticAIEngineerRoadmap(2026)InterviewQ&A

9

anLLMjudgewitharubric,butkeepitasasecondlayer.Ifverificationfails,routetoarepairsteporaskforclarification.

4.9Question:Whatarethetradeoffsofparallelizingagentsteps?

Answer:Paralleltoolcallsreducelatencybutcanwastecostifmanycallsareunnecessary.ParallelLLMcallsimprovequalityvia“self-consistency”butincreaseexpense.Youshouldparallelizewhereuncertaintyishighandresultsarereusable,andserializewheredecisionsdependonpriorresults.Alwayscapconcurrencyandhandleratelimits.

4.10Question:Howdoyouhandlelong-runningtasks(minutes/hours)withagents?

Answer:Useasyncjobswithpersistentstate(DB/queue)andcheckpointaftereachstep.EmitprogresseventstotheUI.Designidempotenttoolcallssoretriesdon’tduplicatesideeffects.Forworkflows,model“resumefromcheckpoint”sothesystemcanrecoverafterrestarts.

10

AgenticAIEngineerRoadmap(2026)InterviewQ&A

6MemoryManagement(Short-Term,Long-Term,Checkpointing)

5.1Question:Whatisthedifferencebetweenshort-termandlong-termmemoryinagenticAI?Answer:Short-termmemoryistheimmediateconversation/contextwindow:recentturns,tooloutputs,currenttaskstate.Long-termmemoryisstoredexternally:databases,vectorstores,userprofiles,summaries.Short-termisfastbutlimited;long-termisscalablebutneedsretrievalandrelevancefiltering.Engineeringischoosingwhattostoreandwhentoretrieve.

5.2Question:Whenshouldyoustorememoryastextsummariesvsembeddings?

Answer:Usesummariesfor“whathappened”inasession(decisions,commitments,preferences).Useembeddingsforlargeknowledgewhereyouneedsemanticretrieval(notes,docs,pasttickets).Oftenyoucombineboth:asummaryforquickcontextplusembeddingsfordetailedrecall.Alsoconsiderstructuredmemory(key-value)forstablefactslikeauser’spreferredunitsorlanguage.

5.3Question:Whatischeckpointingandwhyisitimportant?

Answer:Checkpointingsavesworkflowstateafterstepssoyoucanresumeafterfailures,timeouts,orhumanapprovals.It’scriticalforlong-runningagentsandforauditability.Agoodcheckpointincludesinputs,toolcalls,outputs,andaversionofprompts/policies.Thisenablesreplayanddebugging.

5.4Question:Howdoyoupreventmemoryfromcausingprivacyorsecurityissues?

Answer:Applydataminimization:storeonlywhatyouneed.Encryptatrest,restrictaccessbytenant,andsetretentionpolicies.Avoidstoringsecrets,credentials,orsensitivePII.Ifyoumuststoreuser-specificmemory,giveuserstransparencyandcontrols.Alsosanitizetooloutputsbeforesaving.

5.5Question:Whatis“contextbudgeting”formemory?

Answer:It’sdecidinghowmuchofthecontextwindowtoallocatetoinstructions,recentchat,retrieveddocs,andmemory.Youcanenforcebudgets:e.g.,max30%forretrieveddocs,max20%formemorysummary.Whenexceedingbudgets,compress:summarize,deduplicate,anddroplow-valuecontent.Abudgetpreventscriticalinstructionsfrombeingcrowdedout.

5.6Question:Howdoyouevaluatewhethermemoryhelpsorhurts?

Answer:RunA/Btestswithandwithoutmemoryandcomparetasksuccess,hallucinationrate,andusersatisfaction.Memorycanhurtbyintroducingoutdatedorirrelevantfacts.Usefreshnessscoringandconflictresolutionrules.Ininterviews,mentionmonitoring“memoryhitrate”and“memory-inducederror”cases.

5.7Question:Explain“recency”vs“relevance”inmemoryretrieval.

Answer:Recencyprioritizesnewerinfo;relevanceprioritizessemanticsimilarity.Inpracticeyoubalanceboth:retrievetopsemanticmatches,thenre-rankbyrecencyandtrust.Foruserpreferences,recencycanmatter(peoplechangetheirmind).Forstablefacts,relevancedominates.

5.8Question:Howdoyouimplementmemoryformulti-agentsystems?

Answer:Decidewhatissharedvsprivate.Sharedmemorymightincludeataskplanandverifiedfacts;privatememorymightincludeaspecialistagent’sintermediatenotes.Use

AgenticAIEngineerRoadmap(2026)InterviewQ&A

11

structuredstatepassedthroughthegraphastheprimary“truth,”andstorelong-termartifactsexternally.Alwaysincludeprovenance:whereeachmemorycamefromandwhen.

5.9Question:Whatarecommonfailuremodesoflong-termmemory?

Answer:Retrievingirrelevantchunks,storingnoisyorunverifiedinformation,andfeedbackloopswherehallucinationsgetstoredasmemory.Also:stalepreferencesandconflictingmemories.Mitigatewithvalidation(storeonlyverifiedfacts),decay/expiration,anda“donotstore”policyforuncertaincontent.Agoodruleis“onlystorewhatyoucanjustify.”

5.10Question:Howdoyouhandleusercorrectionstomemory?

Answer:Treatusercorrectionsashighpriority.Updatestructuredmemoryfieldsandmarkoldentriesasdeprecatedratherthandeletingblindly(forauditability).Ifusingembeddings,storeanewcorrectivenoteandre-rankbyrecency.ExposeasimpleUI/commandforuserstoviewandeditwhatisremembered.

AgenticAIEngineerRoadmap(2026)InterviewQ&A

12

7ToolIntegration(CustomTools,Connectors,Decorators)

6.1Question:Whatmakesatool“agent-friendly”?

Answer:Clearname,narrowpurpose,typedinputschema,deterministicoutput,andfastfailure.Toolsshouldreturnstructureddata,notlongnarratives.Theyshouldenforcetimeoutsandreturnhelpfulerrorcodes.Agent-friendlytoolsareeasytotestandsafetocallrepeatedly.

6.2Question:Howdoyousafelyexposetoolsthathavesideeffects(email,purchases,deletes)?

Answer:Useleastprivilegeandseparate“read”toolsfrom“write”tools.Requireexplicitconfirmationsforirreversibleactions.Addpolicychecksandhuman-in-the-loopapprovals.Logeveryactionwithinputs,outputs,anduseridentity.Ininterviews,emphasizethattheagentshouldneverdirectlyexecutehigh-riskactionswithoutguardrails.

6.3Question:Explaintheroleofanallowlistandsandboxfortools.

Answer:Anallowlistlimitswhichtoolsthemodelcancall.Asandboxlimitswhatthosetoolscando(e.g.,restrictedfilesystem,networkegressrules).Togethertheyreducedamagefromhallucinatedtoolcallsorpromptinjection.Itisstandardtoblockarbitrarycodeexecutionunlesstheenvironmentisfullyisolatedandaudited.

6.4Question:Howdoyoudesigntooloutputstominimizecontextbloat?

Answer:Returnonlywhattheagentneeds:concisefieldsandsummaries.Providepaginationor“top-k”results.StripHTML,logs,andirrelevantmetadata.Ifneeded,storelargerawoutputsexternallyandreturnashortreferenceID.Thiskeepsthecontextwindowfocusedandcheaper.

6.5Question:Showaminimalexampleofacustomtoolwrapperfunction.

Answer:Keepitdeterministic,validated,andtimeout-safe.

import

httpx

frompydanticimportBaseModel

classSearchArgs(BaseModel):

q:str

k:int=5

asyncdefweb_search(args:SearchArgs)->dict:

asyncwith

httpx.AsyncClient

(timeout=10.0)asc