Improving Examples in Web API Specifications using Iterated-Calls In-Context Learning

Fuente: arXiv
Salvato in:
Dettagli Bibliografici
Autori principali: Jain, Kush, Kate, Kiran, Tsay, Jason, Goues, Claire Le, Hirzel, Martin
Natura: Preprint
Pubblicazione: 2025
Soggetti:
Accesso online:
Tags: Aggiungi Tag
Nessun Tag, puoi essere il primo ad aggiungerne!!
_version_ 1866908311074373632
author Jain, Kush
Kate, Kiran
Tsay, Jason
Goues, Claire Le
Hirzel, Martin
author_facet Jain, Kush
Kate, Kiran
Tsay, Jason
Goues, Claire Le
Hirzel, Martin
contents Examples in web API specifications can be essential for API testing, API understanding, and even building chat-bots for APIs. Unfortunately, most API specifications lack human-written examples. This paper introduces a novel technique for generating examples for web API specifications. We start from in-context learning (ICL): given an API parameter, use a prompt context containing a few examples from other similar API parameters to call a model to generate new examples. However, while ICL tends to generate correct examples, those lack diversity, which is also important for most downstream tasks. Therefore, we extend the technique to iterated-calls ICL (ICICL): use a few different prompt contexts, each containing a few examples,to iteratively call the model with each context. Our intrinsic evaluation demonstrates that ICICL improves both correctness and diversity of generated examples. More importantly, our extrinsic evaluation demonstrates that those generated examples significantly improve the performance of downstream tasks of testing, understanding, and chat-bots for APIs.
format Preprint
id arxiv_https___arxiv_org_abs_2504_07250
institution arXiv
publishDate 2025
record_format arxiv
spellingShingle Improving Examples in Web API Specifications using Iterated-Calls In-Context Learning
Jain, Kush
Kate, Kiran
Tsay, Jason
Goues, Claire Le
Hirzel, Martin
Software Engineering
Examples in web API specifications can be essential for API testing, API understanding, and even building chat-bots for APIs. Unfortunately, most API specifications lack human-written examples. This paper introduces a novel technique for generating examples for web API specifications. We start from in-context learning (ICL): given an API parameter, use a prompt context containing a few examples from other similar API parameters to call a model to generate new examples. However, while ICL tends to generate correct examples, those lack diversity, which is also important for most downstream tasks. Therefore, we extend the technique to iterated-calls ICL (ICICL): use a few different prompt contexts, each containing a few examples,to iteratively call the model with each context. Our intrinsic evaluation demonstrates that ICICL improves both correctness and diversity of generated examples. More importantly, our extrinsic evaluation demonstrates that those generated examples significantly improve the performance of downstream tasks of testing, understanding, and chat-bots for APIs.
title Improving Examples in Web API Specifications using Iterated-Calls In-Context Learning
topic Software Engineering
url https://arxiv.org/abs/2504.07250