wehub-resource-sync
0d3cb498a3
Deploy local.promptfoo.app / Deploy to Cloudflare Pages (push) Waiting to run
Test and Publish Multi-arch Docker Image / test (push) Waiting to run
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-amd64 platform:linux/amd64 runner:ubuntu-latest]) (push) Blocked by required conditions
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-arm64 platform:linux/arm64 runner:ubuntu-24.04-arm]) (push) Blocked by required conditions
Test and Publish Multi-arch Docker Image / merge-docker-digests (push) Blocked by required conditions
Test and Publish Multi-arch Docker Image / Attest Multi-arch Image (push) Blocked by required conditions
Validate Renovate Config / Validate Renovate Configuration (push) Waiting to run
CI / Shell Format Check (push) Has been cancelled
CI / Check Ruby (3.4) (push) Has been cancelled
CI / CI Config (push) Has been cancelled
CI / Test on Node ${{ matrix.node }} and ${{ matrix.os }}${{ matrix.shard && format(' (shard {0}/3)', matrix.shard) || '' }} (push) Has been cancelled
CI / Build on Node ${{ matrix.node }} (push) Has been cancelled
CI / Style Check (push) Has been cancelled
CI / Generate Assets (push) Has been cancelled
CI / Check Python (3.14) (push) Has been cancelled
CI / Check Python (3.9) (push) Has been cancelled
CI / Build Docs (push) Has been cancelled
CI / Code Scan Action (push) Has been cancelled
CI / Site tests (push) Has been cancelled
CI / webui tests (push) Has been cancelled
CI / Run Integration Tests (push) Has been cancelled
CI / Run Smoke Tests (push) Has been cancelled
CI / Go Tests (push) Has been cancelled
CI / Share Test (push) Has been cancelled
CI / Redteam (Production API) (push) Has been cancelled
CI / Redteam (Staging API) (push) Has been cancelled
CI / GitHub Actions Lint (push) Has been cancelled
CI / Check Ruby (3.0) (push) Has been cancelled
release-please / release-please (push) Has been cancelled
release-please / build (push) Has been cancelled
release-please / publish-npm (push) Has been cancelled
release-please / publish-npm-backfill (push) Has been cancelled
release-please / docker (push) Has been cancelled
release-please / publish-code-scan-action (push) Has been cancelled
release-please / attest-code-scan-action (push) Has been cancelled
85 lines
2.7 KiB
Markdown
85 lines
2.7 KiB
Markdown
# config-custom-prompt-function (Prompt Functions and Format Examples)
|
|
|
|
You can run this example with:
|
|
|
|
```bash
|
|
npx promptfoo@latest init --example config-custom-prompt-function
|
|
cd config-custom-prompt-function
|
|
```
|
|
|
|
This example demonstrates the full range of prompt formats supported by promptfoo, with special focus on prompt functions that can return both content and configuration.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Copy this example to your project
|
|
npx promptfoo@latest init --example config-custom-prompt-function
|
|
|
|
# Set required API keys
|
|
export OPENAI_API_KEY=your_openai_key
|
|
export ANTHROPIC_API_KEY=your_anthropic_key
|
|
|
|
# Run the evaluation
|
|
npx promptfoo@latest eval
|
|
|
|
# View results
|
|
npx promptfoo@latest view
|
|
```
|
|
|
|
## What This Example Shows
|
|
|
|
### Supported Prompt Formats
|
|
|
|
- Raw text prompts
|
|
- File-based prompts (txt, yaml, json, jsonl, md, j2)
|
|
- Glob patterns for multiple files
|
|
- JSON chat formats
|
|
- Markdown formatted prompts
|
|
- Jinja2 template files
|
|
|
|
### Prompt Functions
|
|
|
|
- JavaScript prompt functions (CommonJS and ESM)
|
|
- TypeScript prompt functions
|
|
- Python prompt functions and class methods
|
|
- Multiple functions in a single file
|
|
- **Dynamic configuration** - returning `{ prompt, config }` objects that override provider settings
|
|
|
|
## Example Structure
|
|
|
|
- `prompt.txt`, `prompt.yaml`, etc. - Various prompt file formats
|
|
- `prompt.j2` - Jinja2 template format
|
|
- `prompt_chat.js/ts` - Chat format examples
|
|
- `prompt_multiple.js` - Multiple functions in one file
|
|
- `prompt_esm.mjs` - ESM module format
|
|
- `prompt_python.py` - Python examples
|
|
- `prompt_config.js/py` - Functions returning dynamic configuration
|
|
- `subfolder/` - Demonstrates nested file structures
|
|
- `promptfooconfig.yaml` - Complete configuration showing all prompt types
|
|
|
|
## Configuration Features
|
|
|
|
- Dynamic adjustment of model parameters (temperature, tokens) based on content
|
|
- Content-aware JSON schema formatting
|
|
- Configuration merging (function values override provider defaults)
|
|
- Provider-specific prompt configurations
|
|
- Multiple provider comparisons (OpenAI and Anthropic)
|
|
|
|
## Customization
|
|
|
|
To adapt this example:
|
|
|
|
1. Explore different prompt formats to find what works best for your use case
|
|
2. Use dynamic configurations to optimize model behavior based on input context
|
|
3. Compare how different providers respond to the same prompts
|
|
4. Create your own prompt functions for advanced use cases
|
|
|
|
## Documentation
|
|
|
|
Learn more about:
|
|
|
|
- [Prompt Formats](https://www.promptfoo.dev/docs/configuration/prompts/#prompts)
|
|
- [Prompt Functions](https://www.promptfoo.dev/docs/configuration/prompts/#prompt-functions)
|
|
- [Provider Configuration](https://www.promptfoo.dev/docs/providers/)
|
|
- [JSON Schema Response Formats](https://www.promptfoo.dev/docs/providers/openai/#json-mode-structured-outputs)
|