Skip to content

Commit 3051bd1

Browse files
tylerslatonclaude
andcommitted
fix(docs): correct quickstart errors and API examples across integrations
- Agent-spec: remove invalid CLI `-f agent-spec` option, link to manual setup - A2A: fix env var (GEMINI_API_KEY) and port (10002) to match starter template - AWS Strands: fix useRenderTool to use Zod schema and correct render props - LangGraph: add auth guide cross-reference in configurable docs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent bb96398 commit 3051bd1

4 files changed

Lines changed: 26 additions & 38 deletions

File tree

docs/content/docs/integrations/a2a/quickstart.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Before you begin, you'll need the following:
6060
Create a `.env` file in your agent directory and add your Google API key:
6161

6262
```plaintext title="agent/.env"
63-
GOOGLE_API_KEY=your_google_api_key
63+
GEMINI_API_KEY=your_gemini_api_key
6464
```
6565

6666
<Callout type="info" title="What about other models?">
@@ -107,7 +107,7 @@ Before you begin, you'll need the following:
107107
<Accordions className="mb-4">
108108
<Accordion title="Troubleshooting">
109109
- If you're having connection issues, try using `0.0.0.0` or `127.0.0.1` instead of `localhost`
110-
- Make sure your agent is running on port 8000
110+
- Make sure your agent is running on port 10002
111111
- Check that your Google API key is correctly set
112112
</Accordion>
113113
</Accordions>

docs/content/docs/integrations/aws-strands/generative-ui/tool-rendering.mdx

Lines changed: 19 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -105,35 +105,34 @@ Now we'll use the `useRenderTool` hook to render the tool call in the UI with a
105105

106106
import { useRenderTool } from "@copilotkit/react-core/v2"; // [!code highlight]
107107
import { CopilotSidebar } from "@copilotkit/react-core/v2";
108+
import { z } from "zod"; // [!code highlight]
108109

109110
export default function Page() {
110111
// [!code highlight:41]
112+
const weatherParams = z.object({
113+
location: z.string().describe("The location to get weather for"),
114+
});
115+
111116
useRenderTool({
112117
name: "get_weather",
113-
parameters: [
114-
{
115-
name: "location",
116-
description: "The location to get weather for",
117-
required: true,
118-
},
119-
],
120-
render: ({ status, args, result }) => {
118+
parameters: weatherParams,
119+
render: ({ status, parameters, result }) => {
121120
if (status === "executing") {
122121
return (
123122
<div className="p-4 bg-blue-50 rounded-lg">
124123
<p className="text-sm text-blue-600">
125-
Getting weather for {args.location}...
124+
Getting weather for {parameters.location}...
126125
</p>
127126
</div>
128127
);
129128
}
130129

131130
if (status === "complete" && result) {
132-
const weather = result;
131+
const weather = JSON.parse(result);
133132
return (
134133
<div className="p-4 bg-white border rounded-lg shadow-sm">
135134
<h3 className="font-semibold text-lg mb-2">
136-
Weather in {args.location}
135+
Weather in {parameters.location}
137136
</h3>
138137
<div className="space-y-1 text-sm">
139138
<p>🌡️ Temperature: {weather.temperature}°F</p>
@@ -178,26 +177,24 @@ You should see the custom UI component render with the weather information beaut
178177
You can access the tool arguments even while the tool is still executing:
179178

180179
```tsx
180+
const weatherParams = z.object({
181+
location: z.string().describe("The location to get weather for"),
182+
});
183+
181184
useRenderTool({
182185
name: "get_weather",
183-
parameters: [
184-
{
185-
name: "location",
186-
description: "The location to get weather for",
187-
required: true,
188-
},
189-
],
190-
render: ({ status, args, result }) => {
191-
// args is available immediately, even when status is "executing"
192-
const location = args.location;
186+
parameters: weatherParams,
187+
render: ({ status, parameters, result }) => {
188+
// parameters is available immediately, even when status is "executing"
189+
const location = parameters.location;
193190

194191
return (
195192
<div className="p-4 bg-blue-50 rounded-lg">
196193
{status === "executing" && (
197194
<p>Fetching weather for {location}...</p>
198195
)}
199196
{status === "complete" && result && (
200-
<p>Weather in {location}: {result.temperature}°F</p>
197+
<p>Weather in {location}: {JSON.parse(result).temperature}°F</p>
201198
)}
202199
</div>
203200
);

docs/content/docs/integrations/langgraph/configurable.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ If you wish to read further, you can refer to [the configuration guide by LangGr
1414

1515
This is useful when you want to send execution-time configuration information (such as different tokens or metadata for a given session) that should not be part of the agent state.
1616

17+
<Callout type="info" title="Looking for authentication?">
18+
If you need to pass authentication tokens specifically, see the dedicated [Authentication guide](/langgraph/auth) which covers LangGraph Platform and self-hosted authentication patterns in detail.
19+
</Callout>
20+
1721
## Implementation
1822

1923
By default, LangGraph agents are invoked with a `config` argument. This config has a `configurable` property which can be accessed and filled with your data.

docs/snippets/integrations/agent-spec/run-and-connect.mdx

Lines changed: 1 addition & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,4 @@ import { Accordions, Accordion } from "fumadocs-ui/components/accordion";
22

33
You'll need to run your agent and connect it to CopilotKit before proceeding.
44

5-
If you don't already have CopilotKit and your agent connected, choose one of the following options:
6-
7-
<Accordions>
8-
<Accordion title="I already have an agent">
9-
You can follow the instructions in the [quickstart](/agent-spec/quickstart) guide.
10-
</Accordion>
11-
<Accordion title="I want to start from scratch">
12-
Run the following command to create a brand new project with a pre-configured agent:
13-
14-
```bash
15-
npx copilotkit@latest create -f agent-spec
16-
```
17-
</Accordion>
18-
</Accordions>
5+
If you don't already have CopilotKit and your agent connected, follow the [quickstart](/agent-spec/quickstart) guide to set up your project manually.

0 commit comments

Comments
 (0)