Cookbook
Cookbook \ Instructor \ Basics
- Basic use
- Specifying required and optional parameters via constructor
- Getters and setters
- Private vs public object field
- Basic use via mixin
- Fluent API
- Handling errors with `Maybe` helper class
- Mixed Type Property
- Modes
- Making some fields optional
- Automatic correction based on validation results
- Using attributes
- Using LLM API connection presets from config file
- Validation
- Custom validation using Symfony Validator
- Validation across multiple fields
- Validation with LLM
Cookbook \ Instructor \ Advanced
- Use custom configuration providers
- Context caching (structured output)
- Customize parameters of LLM driver
- Custom prompts
- Customize parameters via DSN
- Extracting arguments of function or method
- Logging monolog
- Logging psr
- Streaming partial updates during inference
- Providing example inputs and outputs
- Extracting scalar values
- Extracting sequences of objects
- Streaming
- Structures
Cookbook \ Instructor \ Troubleshooting
Cookbook \ Instructor \ LLM API Support
Cookbook \ Instructor \ Extras
- Extraction of complex objects
- Extraction of complex objects (Anthropic)
- Extraction of complex objects (Cohere)
- Extraction of complex objects (Gemini)
- Using structured data as an input
- Image processing - car damage detection
- Image to data (OpenAI)
- Image to data (Anthropic)
- Image to data (Gemini)
- Generating JSON Schema from PHP classes
- Generating JSON Schema from PHP classes
- Generating JSON Schema dynamically
- Create tasks from meeting transcription
- Translating UI text fields
- Web page to PHP objects
Cookbook \ Polyglot \ LLM Basics
- Working directly with LLMs
- Working directly with LLMs and JSON - JSON mode
- Working directly with LLMs and JSON - JSON Schema mode
- Working directly with LLMs and JSON - MdJSON mode
- Working directly with LLMs and JSON - Tools mode
- Generating JSON Schema from PHP classes
- Generating JSON Schema from PHP classes
Cookbook \ Polyglot \ LLM Advanced
Cookbook \ Polyglot \ LLM Troubleshooting
Cookbook \ Polyglot \ LLM API Support
Cookbook \ Polyglot \ LLM Extras
Cookbook \ Prompting \ Zero-Shot Prompting
Cookbook \ Prompting \ Few-Shot Prompting
Cookbook \ Prompting \ Thought Generation
Cookbook \ Prompting \ Miscellaneous
- Arbitrary properties
- Consistent values of arbitrary properties
- Chain of Summaries
- Chain of Thought
- Single label classification
- Multiclass classification
- Entity relationship extraction
- Handling errors
- Limiting the length of lists
- Reflection Prompting
- Restating instructions
- Ask LLM to rewrite instructions
- Expanding search queries
- Summary with Keywords
- Reusing components
- Using CoT to improve interpretation of component data
Cookbook \ Instructor \ Basics
Specifying required and optional parameters via constructor
Overview
Instructor can extract data from the LLM response and use it to instantiate an object via constructor parameters.
Instructor will use the constructor parameters nullability and default values to determine which parameters are required and which are optional.
Example
Copy
<?php
require 'examples/boot.php';
use Cognesy\Instructor\StructuredOutput;
class UserWithConstructor
{
public string $name;
private ?int $age;
private string $location;
private string $password;
public function __construct(
string $name, // required - required in constructor, required internally
int $age, // required - required in constructor, even if nullable internally
?string $location, // optional - nullable in constructor, even if required internally
string $password = '123admin' // optional - has a default value, even if required internally
) {
$this->name = $name;
$this->age = $age;
$this->location = $location ?? '';
$this->password = $password;
}
public function getAge(): int {
return $this->age;
}
public function getLocation(): string {
return $this->location;
}
public function getPassword(): string {
return $this->password;
}
}
$text = <<<TEXT
Jason is 25 years old.
TEXT;
$user = (new StructuredOutput)
->withMessages($text)
->withResponseClass(UserWithConstructor::class)
->get();
dump($user);
assert($user->name === "Jason");
assert($user->getAge() === 25);
assert($user->getPassword() === '123admin');
assert($user->getLocation() === ''); // default value for location
?>
Assistant
Responses are generated using AI and may contain mistakes.