Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [agentic-ai-dev] Consensus on API
  • From: Reza Rahman <reza_rahman@xxxxxxxx>
  • Date: Thu, 26 Mar 2026 08:04:07 -0400
  • Delivered-to: agentic-ai-dev@xxxxxxxxxxx
  • List-archive: <https://www.eclipse.org/mailman/private/agentic-ai-dev/>
  • List-help: <mailto:agentic-ai-dev-request@eclipse.org?subject=help>
  • List-subscribe: <https://www.eclipse.org/mailman/listinfo/agentic-ai-dev>, <mailto:agentic-ai-dev-request@eclipse.org?subject=subscribe>
  • List-unsubscribe: <https://www.eclipse.org/mailman/options/agentic-ai-dev>, <mailto:agentic-ai-dev-request@eclipse.org?subject=unsubscribe>
  • Ui-outboundreport: notjunk:1;M01:P0:RIdBAsrAIO0=;F/glQI82ZdvOXTCvFwsRq4t7QFV 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
This is certainly a worthwhile conversation. I have documented what I think here: https://github.com/jakartaee/agentic-ai/issues/23. We can continue the conversation in either place though. Others should feel free to chime in, but I definitely think this is out of scope for a v1 for us. It may even be out of scope for several versions or altogether.

On Mar 26, 2026, at 2:52 AM, Juan G <juangon@xxxxxxxxx> wrote:


For me I think I am not missing anything, except adding tool calling support for LargeLanguageModel interface (https://github.com/jakartaee/agentic-ai/blob/main/api/src/main/java/jakarta/ai/agent/LargeLanguageModel.java). This would be used in many agents for sure, and defining in the API would require that any LLM provider should make the impl.

This would need another Record for storing ToolResponse, and probably creating other ones (such as ToolCall, have to think a little bit...).

Other option is let as it is, without defining in this API explicitly, and implement using <T> T query(String prompt, Class<T> resultType); somehow, but the tool call should be implemented somewhere else.


El dom, 22 mar 2026 a las 0:17, Reza Rahman via agentic-ai-dev (<agentic-ai-dev@xxxxxxxxxxx>) escribió:
Folks,

Our next step is to publish the API to Maven staging. This will effectively make it available to developers. Before we do that step, I would like to reach committer consensus.

I do hope that by now you have taken some time to review the context. I now ask that you carefully review the proposed API: https://github.com/jakartaee/agentic-ai/tree/main/api. While the specification document will have a lot more details, a great deal of the behavior is actually already documented in the API Javadoc.

Please provide your feedback and comments here. I will spin out separate threads to keep the discussion focused if necessary. I would like to see if we can achieve consensus by Friday. In that spirit, if everything looks good from a v1 perspective, I ask that you please respond with a +1 so I can count your vote.

Onward!

Cheers,
Reza
_______________________________________________
agentic-ai-dev mailing list
agentic-ai-dev@xxxxxxxxxxx
To unsubscribe from this list, visit https://accounts.eclipse.org


--
----------------------------

Juan G.

Back to the top