Generate Requests with AI
Generating sample request data is a common and often tedious task in API development.
Studio has an opt-in, experimental feature to help you generate request payloads using an LLM of your choice. We call this AI Request Autofill, because that name seemed pretty descriptive.
Let’s walk through an example, then we can touch on how to enable AI Request Autofill, how it works under the hood, and where it works best.
Example: Creating a sample payload
Let’s say we have a route POST /api/goose
that creates a new goose. This route expects a JSON body with the following shape:
In the Fiberplane Studio UI, Studio’s AI can generate these fields for us. Once we’ve enabled AI Request Autofill, we can click the Magic Wand icon on the requests page to generate some request data. (Feel free to also use the shortcut cmdg.)
In this case, Studio will generate a request body with the shape above.
Looks like we’re going to create a goose named “Gus” who loves Golang. Very alliterative!
After this, we could go ahead and click Send (or press cmdenter), and Studio will send the request to the API and create Gus.
Under the hood, Studio keeps track of the most recent requests you’ve made to your API in order to generate request data that follows your current testing path.
So, besides generating a request body, Studio can also prefill data for:
- URL path parameters
- Query parameters
- Request Headers
For example, if you just created a goose named “Gus”, and its id was 123
, Studio will use that id when you generate parameters for a route like GET /api/goose/:id
or DELETE /api/goose/:id
.
Before showing any more examples, though, let’s talk about how to get this thing configured.
Enabling Request Autofill
First, we need to enable AI features in Studio. Head on over to the Settings page and select the section “Request Autofill”.
Toggle “Enable Request Autofill”, and then configure the AI provider and model you want to use.
As of writing, Studio supports both OpenAI and Anthropic as LLM providers, and allows selection of the following models:
- Claude 3.5 Sonnet - Claude 3 Opus - Claude 3 Sonnet - Claude 3 Haiku
You can select the provider and model once you’ve enabled AI Request Autofill.
Once you’ve selected the provider and model, fill in your API key and click “Save”. You’re ready to go!
The API key is stored locally in your project, and ignored by git by default. (Specifically, it’s stored in a local database, which you can find in .fpxconfig/fpx.db
.)
Using a different LLM provider
If your LLM provider exposes an API that is compatible with OpenAI or Anthropic, you can use it. You just need to set the base URL in your provider configuration.
This is a way to use a local AI, if you’re so inclined! There are instructions in our GitHub repo on how to do this. Just be warned: in our experiments with running local models, request parameters would often take 10+ seconds to generate, which is a little slow 🐢.
Example: Testing like a QA Engineer
By default, Studio will generate request data that takes inspiration from the most recent requests you’ve made to your API, and it will try to help you test the happy path.
If you want to change this behavior, click the caret by the magic wand icon, and select “Hostile” underneath “Testing Persona”.
In this case, if we’re testing a route like GET /api/goose/:id
, Studio will generate a url parameter like invalid_id
.
This is a great way to test the resilience of your API to unexpected and invalid inputs.
How all of this works
The AI generates a request based on the following:
- The most recent requests you’ve made to your API
- The handler code for the request you’re currently working on
If you imported an OpenAPI spec, the AI will also generate requests based on the definitions in the spec.
What does this mean in practice? Well, if your request handler shells out to several helper functions to parse and transform the request data, Studio will struggle to guess the correct request data. We are working on ways to improve this.
What gets sent to the LLM?
In order to generate a request, Studio sends the following to the AI provider you chose:
- The most recent requests you’ve made to your API
- The source code for the handler of the request you’re currently working on
- The OpenAPI spec for your route, if you imported one
- The request you’re currently working on
Certain sensitive headers are redacted by default, like Authorization
and Cookie
.
We don’t recommend using this feature when working with sensitive production data.
Furthermore, if you’re using Fiberplane Studio at work, make sure your organization’s policies allow sending source code to a 3rd party like OpenAi or Anthropic.