Prism Workers AI — A Cloudflare Workers AI Provider for Prism PHP

What is Prism Workers AI and How Does It Work?

Prism Workers AI is a Cloudflare Workers AI provider that acts as a bridge between Cloudflare’s AI Gateway and the Prism PHP framework. It enables developers to access a variety of AI models hosted on Cloudflare Workers by routing requests through the AI Gateway’s /compat endpoint. This setup allows for generating natural language text, creating embeddings, and executing complex workflows with multi-step tool calls.

The provider supports both synchronous and streaming responses, allowing applications to deliver real-time AI-generated content. It also maintains session affinity, which means the conversational context is preserved across multiple requests, improving the quality and relevance of AI interactions.

Key Features of Prism Workers AI

• Text generation and streaming with support for various Cloudflare AI models, including large-scale instruct models.
• Embedding generation using Cloudflare’s vector models to create semantic representations of text.
• Multi-step tool calling workflows that automate complex AI-driven tasks.
• Extraction of reasoning content from supported models, providing transparency into AI decision-making.
• Session affinity for maintaining conversation context and prompt prefix caching.
• Seamless integration with the Laravel AI SDK’s agent() helper for streamlined AI interactions in Laravel applications.

How to Use Prism Workers AI for Text Generation

Using Prism Workers AI for text generation is straightforward with Prism PHP’s fluent API. Developers specify the AI model from Cloudflare’s Workers AI catalog and provide a prompt to generate text. Streaming responses are supported, enabling applications to display AI-generated text as it is produced.

Example usage:

use PrismPrismFacadesPrism;

$response = Prism::text()
    ->using('workers-ai', 'workers-ai/@cf/meta/llama-3.3-70b-instruct-fp8-fast')
    ->withPrompt('Hello!')
    ->asText();

$stream = Prism::text()
    ->using('workers-ai', 'workers-ai/@cf/meta/llama-3.3-70b-instruct-fp8-fast')
    ->withPrompt('Tell me a story')
    ->asStream();

This approach allows developers to integrate advanced natural language processing capabilities directly into their Laravel applications with minimal setup.

Generating Embeddings with Prism Workers AI

Embeddings are crucial for semantic search, recommendation systems, and clustering. Prism Workers AI supports embedding generation using Cloudflare’s embedding models, allowing developers to convert text inputs into high-dimensional vectors.

Example embedding generation:

$response = Prism::embeddings()
    ->using('workers-ai', 'workers-ai/@cf/baai/bge-large-en-v1.5')
    ->fromInput('Hello world')
    ->generate();

This feature enables developers to build intelligent data-driven applications that leverage vector representations for enhanced AI performance.

Automating Complex Workflows with Tool Calling

Prism Workers AI supports multi-step tool calling, enabling automation of complex AI workflows. This is particularly useful for scenarios where multiple AI tools or APIs need to be orchestrated in sequence.

For example, a weather information tool can be integrated into an AI assistant workflow:

$response = Prism::text()
    ->using('workers-ai', 'workers-ai/@cf/meta/llama-3.3-70b-instruct-fp8-fast')
    ->withTools([$weatherTool])
    ->withMaxSteps(3)
    ->withPrompt('What is the weather?')
    ->asText();

The package automatically manages the requirement that assistant messages contain content during tool calls, simplifying developer workload and ensuring smooth execution.

Extracting Reasoning Content from AI Models

One of the standout features of Prism Workers AI is its ability to extract reasoning content from supported models like Kimi K2.5. This allows developers to access the AI’s internal thought process or reasoning chain alongside the final output, enhancing transparency and trustworthiness.

Example:

$response = Prism::text()
    ->using('workers-ai', 'workers-ai/@cf/moonshotai/kimi-k2.5')
    ->withMaxTokens(2000)
    ->withPrompt('What is 15 * 37?')
    ->asText();

echo $response->text; // "555"
echo $response->steps[0]->additionalContent['thinking']; // "The user is asking for the product of 15 and 37..."

When using streaming, developers receive thinking events before the text output, enabling rich interactive experiences.

Integrating Prism Workers AI with Laravel AI SDK

For Laravel developers using the Laravel AI SDK, Prism Workers AI registers a dedicated workers-ai driver. This allows seamless use of the SDK’s agent() helper to interact with Cloudflare Workers AI models.

Example:

use function LaravelAiagent;

$response = agent(instructions: 'You are a helpful assistant.')
    ->prompt('Hello!', provider: 'workers-ai');

This integration simplifies the adoption of Prism Workers AI in Laravel projects, providing a consistent developer experience across AI providers.

System Requirements and Compatibility

Prism Workers AI requires PHP 8.2 or higher and Prism PHP version ^0.99. It optionally supports Laravel AI SDK version ^0.3 for enhanced Laravel integration. These requirements ensure compatibility with modern PHP environments and Laravel applications.

Benefits of Using Prism Workers AI in Laravel Applications

• Scalability: Cloudflare Workers provide a globally distributed, serverless platform that scales automatically with demand.
• Cost Efficiency: Leveraging Cloudflare’s infrastructure reduces the need for dedicated AI hosting resources.
• Performance: Low-latency AI inference through Cloudflare’s edge network enhances user experience.
• Flexibility: Support for multiple AI models and workflows enables diverse application scenarios.
• Security: Cloudflare’s robust security features protect AI interactions and data.

Practical Use Cases for Prism Workers AI

Developers can leverage Prism Workers AI in various real-world scenarios, including:

• Building conversational AI assistants with contextual understanding and reasoning capabilities.
• Implementing semantic search engines using embedding vectors for improved relevance.
• Automating data processing pipelines with multi-step AI tool workflows.
• Generating dynamic content such as stories, summaries, or explanations in real time.
• Enhancing customer support platforms with AI-driven responses and decision transparency.

Getting Started with Prism Workers AI

To begin using Prism Workers AI, install the package compatible with Prism PHP and ensure your environment meets the PHP and Laravel AI SDK requirements. Then configure your Cloudflare Workers AI credentials and select the desired AI models. The Prism PHP fluent API provides intuitive methods to generate text, embeddings, and manage workflows.

Developers are encouraged to explore the official GitHub repository at meirdick/prism-workers-ai for detailed documentation, examples, and updates.

Challenges and Considerations

While Prism Workers AI offers powerful capabilities, developers should consider:

• Token limits and cost implications when using large models or extensive reasoning workflows.
• Ensuring prompt design aligns with AI model strengths for optimal output quality.
• Handling asynchronous streaming responses effectively in frontend or backend applications.
• Maintaining session affinity carefully to preserve conversation context without excessive resource use.

Proper monitoring and optimization strategies are recommended to maximize ROI and performance.

Future Prospects and Enhancements

As AI technology and Cloudflare Workers evolve, Prism Workers AI is poised to incorporate new models, improved reasoning techniques, and expanded workflow automation. Integration with Laravel’s ecosystem will continue to deepen, making AI more accessible and powerful for PHP developers. The open-source nature of the package encourages community contributions and rapid innovation.

Summary

Prism Workers AI is a comprehensive Cloudflare Workers AI provider tailored for Prism PHP and Laravel AI SDK users. It empowers developers to build sophisticated AI-driven applications with features like natural language generation, embeddings, multi-step workflows, and reasoning content extraction. Its seamless integration, scalability, and performance benefits make it an excellent choice for modern Laravel projects seeking to leverage AI capabilities.

Frequently Asked Questions