[docs] adding docs for cerebras (#1952)

<!-- ELLIPSIS_HIDDEN -->



> [!IMPORTANT]
> Add documentation for Cerebras integration and update prompt
engineering examples and navigation.
> 
>   - **Documentation**:
> - Adds `cerebras.mdx` to document Cerebras integration with OpenAI
client using `openai-generic` provider.
> - Updates `openai-generic.mdx` to include Cerebras in the list of
supported providers.
>   - **Prompt Engineering**:
> - Updates `tools.mdx` with examples for using BAML classes and
functions in Python and TypeScript.
>   - **Navigation**:
> - Updates `docs.yml` to include Cerebras in the navigation under LLM
Client Providers.
> 
> <sup>This description was created by </sup>[<img alt="Ellipsis"
src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=BoundaryML%2Fbaml&utm_source=github&utm_medium=referral)<sup>
for afc02f8. You can
[customize](https://app.ellipsis.dev/BoundaryML/settings/summaries) this
summary. It will automatically update as commits are pushed.</sup>

<!-- ELLIPSIS_HIDDEN -->

Author: hellovai

fern/01-guide/06-prompt-engineering/tools.mdx

@@ -21,6 +21,10 @@ In BAML, you can get represent a `tool` or a `function` you want to call as a BA
 
 ```baml BAML
 class WeatherAPI {
+  // we can use literals to denote the name of the tool
+  // the field can be named anything we want! "api_name" "tool" "function_name"
+  // whatever you feel the LLM would understand best
+  api_name "weather_request"
   city string @description("the user's city")
   timeOfDay string @description("As an ISO8601 timestamp")
 }
@@ -397,11 +401,13 @@ This is what it looks in the BAML file:
 
 ``` Rust tools.baml
 class WeatherAPI {
+  intent "weather_request"
   city string
   time string @description("Current time in ISO8601 format")
 }
 
 class CalculatorAPI {
+  intent "basic_calculator"
   operation "add" | "subtract" | "multiply" | "divide"
   numbers float[]
 }
@@ -418,11 +424,12 @@ function SelectTool(message: string) -> WeatherAPI | CalculatorAPI {
 }
 ```
 
-In our Python code, we'll:
+In our agent code, we'll:
 1. Implement our APIs
 2. Implement our Agent that continuously will use different tools
 
-``` Python toolAgent.py
+<CodeGroup>
+```python toolAgent.py
 from baml_client import b
 from baml_client.types import WeatherAPI, CalculatorAPI
 
@@ -471,6 +478,81 @@ if __name__ == "__main__":
     main()
 ```
 
+```typescript toolAgent.ts
+import { b } from "@/baml_client";
+import { WeatherAPI, CalculatorAPI } from "@/baml-client/types";
+
+function handleWeather(weather: WeatherAPI): string {
+  // Simulate weather API call
+  return `The weather in ${weather.city} at ${weather.time} is sunny.`;
+}
+
+function handleCalculator(calc: CalculatorAPI): string {
+  const numbers = calc.numbers;
+  let result: number;
+
+  switch (calc.operation) {
+    case "add":
+      result = numbers.reduce((a, b) => a + b, 0);
+      break;
+    case "subtract":
+      result = numbers.slice(1).reduce((a, b) => a - b, numbers[0]);
+      break;
+    case "multiply":
+      result = numbers.reduce((a, b) => a * b, 1);
+      break;
+    case "divide":
+      result = numbers.slice(1).reduce((a, b) => a / b, numbers[0]);
+      break;
+    default:
+      return "Unknown operation.";
+  }
+
+  return `The result is ${result}`;
+}
+
+async function main() {
+  console.log("Agent started! Type 'exit' to quit.");
+
+  const readline = await import("readline");
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  rl.on("line", async (input) => {
+    if (input.toLowerCase() === "exit") {
+      rl.close();
+      return;
+    }
+
+    const toolResponse = await b.SelectTool(input);
+
+    switch (toolResponse.intent) {
+      case "weather_request":
+      const result = handleWeather(toolResponse as WeatherAPI);
+      console.log(`Agent (Weather): ${result}`);
+    }
+    if () {
+      const result = handleWeather(toolResponse as WeatherAPI);
+      console.log(`Agent (Weather): ${result}`);
+    } else if ("numbers" in toolResponse && "operation" in toolResponse) {
+      const result = handleCalculator(toolResponse as CalculatorAPI);
+      console.log(`Agent (Calculator): ${result}`);
+    } else {
+      console.log("Agent: Sorry, I couldn't handle that input.");
+    }
+  });
+}
+
+main();
+
+```
+
+</CodeGroup>
+
+
 We can test this by asking things like:
 1. What is the weather in Seattle?
 2. What's 5+2?

fern/03-reference/baml/clients/providers/cerebras.mdx

@@ -0,0 +1,24 @@
+---
+title: Cerebras
+---
+
+[Cerebras](https://inference-docs.cerebras.ai/resources/openai) supports the OpenAI client, allowing you to use the
+[`openai-generic`](/ref/llm-client-providers/openai-generic) provider with an
+overridden `base_url`.
+
+
+See [OpenAI Generic](/ref/llm-client-providers/openai-generic) for more details about parameters.
+
+
+**Example:**
+
+```baml BAML
+client<llm> CerebrasLlama {
+  provider "openai-generic"
+  options {
+    base_url "https://api.cerebras.ai/v1"
+    api_key env.CEREBRAS_API_KEY
+    model "llama-3.3-70b"
+  }
+}
+```

fern/03-reference/baml/clients/providers/openai-generic.mdx

@@ -23,6 +23,7 @@ A non-exhaustive list of providers you can use with `openai-generic`:
 | Inference Provider | Docs |
 | -------------- | -------------- |
 | Azure AI Foundary | [Azure AI Foundary](/ref/llm-client-providers/azure-ai-foundary) |
+| Cerebras | [Cerebras](/ref/llm-client-providers/cerebras) |
 | Groq | [Groq](/ref/llm-client-providers/groq) |
 | Hugging Face | [Hugging Face](/ref/llm-client-providers/huggingface) |
 | Keywords AI | [Keywords AI](/ref/llm-client-providers/keywordsai) |

fern/docs.yml

@@ -739,6 +739,9 @@ navigation:
           - page: "Azure AI Foundary (openai-generic)"
             slug: azure-ai-foundary
             path: 03-reference/baml/clients/providers/azure-ai-foundary.mdx
+          - page: "Cerebras (openai-generic)"
+            slug: cerebras
+            path: 03-reference/baml/clients/providers/cerebras.mdx
           - page: "Groq (openai-generic)"
             slug: groq
             path: 03-reference/baml/clients/providers/groq.mdx