content-agent 0.2.0 → 0.4.1

package/README.md

@@ -64,6 +64,44 @@ const model = contentAgent.agent("my-thread", {
 });
 ```
 
+## Tools
+
+Pass AI SDK tools to `streamText` or `generateText` — tool schemas are forwarded to the agent, and execution happens locally on the client:
+
+```typescript
+import { streamText, tool, stepCountIs } from "ai";
+import { z } from "zod";
+
+const result = streamText({
+  model: contentAgent.agent("my-thread", { application: { key: "my-studio" } }),
+  prompt: `Find all blog posts still in draft and submit them for review. Assign them to anna@example.com.`,
+  tools: {
+    submit_for_review: tool({
+      description: `Submit a document for editorial review. The document must be in draft state.`,
+      inputSchema: z.object({
+        documentId: z.string().describe("The Sanity document _id"),
+        email: z.string().email().describe("Assign a specific reviewer"),
+        note: z.string().optional().describe("Note for the reviewer"),
+      }),
+      execute: async ({ documentId, email, note }) => {
+        const res = await fetch(
+          "https://workflows.internal.example.com/api/review",
+          {
+            method: "POST",
+            body: JSON.stringify({ documentId, email, note }),
+          },
+        );
+
+        const { ticketUrl } = await res.json();
+        return { success: true, documentId, ticketUrl };
+      },
+    }),
+  },
+});
+```
+
+The model decides when to call your tools. `stopWhen` controls how many round-trips are allowed between the model and tool execution.
+
 ## Configuration
 
 Pass settings to `.agent()` to configure capabilities: