Enhance description of entity reference properties with example format

Here is the patch. Let me know if you think…

Thoughts? Does this go in the right direction?

Latest patch based on the current MR.

What it looks like:

Update issue summary.

Reviewed MR and tested changes. Looks good to me! Nice work adding the example format for entity references—makes it much clearer.

These example were a much needed, thanks @bisonbleu.

@bisonbleu - the idea is super, but we should really change the actual description. The description you change there only makes it easier for us humans to understand when using something like the tool explorer, while the actual description is what the agent is using to solve its issue.

Would it be possible for you to try to move almost all code, which looks good, to the following file: src/Plugin/AiFunctionCall/Deriative/ActionPluginDeriver.php?

If I'm right, that would make it so the actions becomes better with the agents as well and shows the message on the Tools Explorer form.

Thanks for all the feedback! Much appreciated.

Ah… yes, smart @Marcus, now I'm starting to see how these description also play as prompts.

Promptscription ;^)

Seriously, when that is the case, maybe we could tag the description label with a small ai-icon to suggest this property?

Ok, I'll give that a try and get back shortly…

Strange, I think the Needs work was set automagically…

I've removed the original description enhancing code from PropertyFormBuilder, it now lives upstream in the ActionPluginDeriver.

Getting merged, thank you @bisonbleu.

Automatically closed - issue fixed for 2 weeks with no activity.