Generar un prompt
Generar un prompt bien escrito
Las APIs de herramientas de prompt están en una vista previa de investigación cerrada. Solicitar unirse a la vista previa de investigación cerrada.
Antes de comenzar
Las herramientas de prompt son un conjunto de APIs para generar y mejorar prompts. A diferencia de nuestras otras APIs, esta es una API experimental: necesitarás solicitar acceso, y no tiene el mismo nivel de compromiso con el soporte a largo plazo que otras APIs.
Estas APIs son similares a lo que está disponible en el Anthropic Workbench, y están destinadas para uso por otras plataformas de ingeniería de prompts y entornos de prueba.
Comenzando con el generador de prompts
Para usar la API de generación de prompts, necesitarás:
- Haberte unido a la vista previa de investigación cerrada para las APIs de herramientas de prompt
- Usar la API directamente, en lugar del SDK
- Agregar el encabezado beta
prompt-tools-2025-04-02
Esta API no está disponible en el SDK
Generar un prompt
Headers
Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like beta1,beta2
or specify the header multiple times for each beta.
Body
Description of the prompt's purpose.
The task
parameter tells Claude what the prompt should do or what kind of role or functionality you want to create. This helps guide the prompt generation process toward your intended use case.
Example:
{"task": "a chef for a meal prep planning service"}
"a chef for a meal prep planning service"
The model this prompt will be used for. This optional parameter helps us understand which models our prompt tools are being used with, but it doesn't currently affect functionality.
Example:
"claude-3-7-sonnet-20250219"
1 - 256
"claude-3-7-sonnet-20250219"
Response
The response contains a list of message objects in the same format used by the Messages API. Typically includes a user message with the complete generated prompt text, and may include an assistant message with a prefill to guide the model's initial response.
These messages can be used directly in a Messages API request to start a conversation with the generated prompt.
Example:
{
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "You are a chef for a meal prep planning service..."
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": "<recipe_planning>"
}
]
}
]
}
[
{
"content": [
{
"text": "<generated prompt>",
"type": "text"
}
],
"role": "user"
}
]
Currently, the system
field is always returned as an empty string (""). In future iterations, this field may contain generated system prompts.
Directions similar to what would normally be included in a system prompt are included in messages
when generating a prompt.
""
Usage information