Basics
Handling errors with `Maybe` helper class
Basics
- Basic use
- Basic use via mixin
- Handling errors with `Maybe` helper class
- Modes
- Making some fields optional
- Private vs public object field
- Automatic correction based on validation results
- Using attributes
- Using LLM API connections from config file
- Validation
- Custom validation using Symfony Validator
- Validation across multiple fields
Advanced
- Context caching
- Context caching (Anthropic)
- Customize parameters of OpenAI client
- Custom prompts
- Using structured data as an input
- Extracting arguments of function or method
- Streaming partial updates during inference
- Providing example inputs and outputs
- Extracting scalar values
- Extracting sequences of objects
- Streaming
- Structures
Troubleshooting
LLM API Support
Extras
- Extraction of complex objects
- Extraction of complex objects (Anthropic)
- Extraction of complex objects (Cohere)
- Extraction of complex objects (Gemini)
- Embeddings
- Image processing - car damage detection
- Image to data (OpenAI)
- Image to data (Anthropic)
- Image to data (Gemini)
- 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
- Prompts
- Generating JSON Schema from PHP classes
- Generating JSON Schema dynamically
- Simple content summary
- Create tasks from meeting transcription
- Translating UI text fields
- Web page to PHP objects
Basics
Handling errors with `Maybe` helper class
Overview
You can create a wrapper class to hold either the result of an operation or an error message. This allows you to remain within a function call even if an error occurs, facilitating better error handling without breaking the code flow.
Example
<?php
$loader = require 'vendor/autoload.php';
$loader->add('Cognesy\\Instructor\\', __DIR__.'../../src/');
use Cognesy\Instructor\Enums\Mode;
use Cognesy\Instructor\Extras\Maybe\Maybe;
use Cognesy\Instructor\Instructor;
class User
{
public string $name;
public int $age;
}
$text = 'We have no information about our new developer.';
echo "\nINPUT:\n$text\n";
$maybeUser = (new Instructor)->respond(
messages: [['role' => 'user', 'content' => $text]],
responseModel: Maybe::is(User::class),
model: 'gpt-4o-mini',
mode: Mode::MdJson,
);
echo "\nOUTPUT:\n";
dump($maybeUser->get());
assert($maybeUser->hasValue() === false);
assert(!empty($maybeUser->error()));
assert($maybeUser->get() === null);
$text = "Jason is our new developer, he is 25 years old.";
echo "\nINPUT:\n$text\n";
$maybeUser = (new Instructor)->respond(
messages: [['role' => 'user', 'content' => $text]],
responseModel: Maybe::is(User::class)
);
echo "\nOUTPUT:\n";
dump($maybeUser->get());
assert($maybeUser->hasValue() === true);
assert(empty($maybeUser->error()));
assert($maybeUser->get() != null);
assert($maybeUser->get() instanceof User);
?>