[Agent] Add Platform tool wrapper for using platforms as tools #722
+140
−2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
carsonbot
added
Status: Needs Review
Bug
carsonbot
changed the title
|
Any idea @chr-hertel ? 
|
OskarStark
changed the title
|
maybe the options argument? not sure |
|
No, even removing the options does not help |
|
Best would be Xdedump i guess |
chr-hertel
reviewed
Oct 6, 2025
Comment on lines
+41
to
+45
| return $this->platform->invoke( | ||
| $this->model, | ||
| $message, | ||
| $this->options, | ||
| )->asText(); |
There was a problem hiding this comment.
check for instanceof TextResult and handle other cases. at least ObjectResult can be json serialized
chr-hertel
reviewed
Oct 6, 2025
Comment on lines
+410
to
+422
| $count = 0; | ||
| if (!empty($v['agent'])) { | ||
| ++$count; | ||
| } | ||
| if (!empty($v['service'])) { | ||
| ++$count; | ||
| } | ||
| if (!empty($v['platform'])) { | ||
| ++$count; | ||
| } | ||
|
|
||
| return 1 !== $count; |
chr-hertel
reviewed
Oct 6, 2025
Comment on lines
+393
to
+398
| ->stringNode('model')->cannotBeEmpty()->end() | ||
| ->arrayNode('options') | ||
| ->info('Options to pass to the platform') | ||
| ->scalarPrototype()->end() | ||
| ->end() |
There was a problem hiding this comment.
can we validate that model and options is only allowed in combination with platform? or do i get it wrong?
Introduces a new Platform tool that wraps any PlatformInterface instance, allowing agents to use specialized platforms as tools. This enables scenarios like an OpenAI agent using ElevenLabs for speech-to-text. - Add Platform tool class with support for Text, Audio, and Image results - Add OpenAI example demonstrating ElevenLabs platform as tool - Add documentation explaining the concept and usage - Update demo AI Bundle configuration with platform tool examples
Platforms can now be configured as tools in agent definitions:
ai:
agent:
my_agent:
tools:
- platform: 'elevenlabs'
model: 'scribe_v1'
name: 'transcribe_audio'
description: 'Transcribes audio files to text'
options: []
This allows agents to use specialized platforms as tools, enabling
scenarios like an OpenAI agent using ElevenLabs for speech-to-text.
Removed explicit await() and result type matching by using the ResultPromise::asText() convenience method which handles the await internally and extracts text content directly.
Updated platform-as-tool.php to follow the same pattern as agent-as-tool.php: - Use MemoryToolFactory to register tool with name and description - Use ChainFactory to combine MemoryToolFactory and ReflectionToolFactory - Provides better tool metadata for the agent
Changed from ElevenLabs speech-to-text example to a simpler OpenAI-only example that mirrors the agent-as-tool pattern: - Main agent uses gpt-4o-mini - Platform tool uses gpt-4o for advanced analysis - Demonstrates using a more powerful model as a tool for complex tasks - Removes external dependency on ElevenLabs API key
Changed from complex philosophical question to the same simple math question used in agent-as-tool.php for consistency and clarity.
- Removed ElevenLabs reference from docblock example - Updated example to use gpt-4o/gpt-4o-mini scenario - Fixed parameter name from $message to $input to match signature
OskarStark
force-pushed
the
OskarStark/platforms-as-tools
branch
from
ec5c747 to
ee38c77
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.