feat: Add api level tool call support (ENG-446)

[monoxgas]

AI-Generated Summary

PR Summary

Overview of Changes

This PR introduces significant enhancements to the Rigging library, focusing on the documentation and expansion of tools. A notable addition is the division of tools into API and Native tools, with improved integration and performance for API tools, along with enhancements to ChatPipeline capabilities and error handling. These changes facilitate more flexible and powerful interactions with Large Language Models (LLMs) through the Rigging framework, allowing users to seamlessly incorporate both predefined and custom tools within chat pipelines.

Key Modifications

1. Expansion of Tools Documentation: Added comprehensive examples and explanations in the documentation for defining and integrating both API and Native tools within the Rigging framework, enabling users to extend the capability of their LLMs with arbitrary code functions.
2. Introduction of ApiTool and Handling in ChatPipeline: Introduced the ApiTool class and updated ChatPipeline to support the usage of API tools, enhancing the integration of external APIs into the chat generation process for a performance boost and better provider integrations.
3. Error Handling Improvements: Added the UnknownToolError exception to better manage errors related to tool usage within ChatPipeline, ensuring a smoother user experience when integrating tools with chat pipelines.
4. Refactor of ChatPipeline to Support Tool Choices: Modified ChatPipeline’s .using() method to allow distinction and separate handling between native tools and API tools, including the introduction of using_native_tools and using_api_tools methods for clearer and more purposeful pipeline construction.

Potential Impact

• Enhanced flexibility and performance for users leveraging tools within their LLM interactions, particularly through improved API tool integration.
• Potential for confusion during the transition phase for existing users accustomed to the previous singular tool approach, requiring adaptation to the new method of specifying and integrating tools.
• Increased complexity in managing chat pipelines, given the broader range of options and configurations available for tool integration.
• Improved error diagnostics through explicit exception handling, aiding in troubleshooting and refining LLM tool interactions.

---

This summary was generated with ❤️ by rigging

[cloudflare-workers-and-pages]

Deploying rigging-docs with    Cloudflare Pages

Latest commit:	76c936d
Status:	✅  Deploy successful!
Preview URL:	https://8954a5eb.rigging-docs.pages.dev
Branch Preview URL:	https://nick-eng-446-add-api-level-t.rigging-docs.pages.dev

View logs