SDK Quickstarts
Conecta tu agente de IA a Trusteed
Ejemplos listos para copiar con los 3 SDKs de IA más usados. Cada ejemplo incluye verificación de trust score.
OpenAI Agents SDK
OpenAI Agents SDK — Python
Instalar
Versión probada: openai-agents ≥ 0.14.0pip install openai-agentsPythonAgente de compras con verificación de confianza
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
async with MCPServerStreamableHttp(
name="trusteed",
params={
"url": "https://trusteed.xyz/demo-store/mcp",
"headers": {"X-Agent-Api-Key": "agnt_your_key"},
"timeout": 30,
},
cache_tools_list=True,
) as mcp:
agent = Agent(
name="shopping-agent",
instructions="""
You are a shopping assistant for Trusteed.
IMPORTANT: Before any checkout, always call get_merchant_profile
and verify trust_score >= 0.70. If lower, stop and inform the user.
Methodology: GET /api/v1/trust/methodology
""",
)
result = await Runner.run_async(
agent,
"Search for laptops under $1500, verify merchant trust, and create a cart."
)
print(result.final_output)
asyncio.run(main())El agente recibe trust_score en la respuesta de get_merchant_profile. Con las instrucciones del system prompt, el modelo verifica automáticamente el umbral antes de llamar a create_cart.
Claude Agent SDK
Claude Agent SDK — TypeScript
Instalar
Versión probada: @anthropic-ai/claude-agent-sdk ≥ 0.2.0npm install @anthropic-ai/claude-agent-sdkNota: El SDK está en desarrollo activo — revisa el CHANGELOG antes de actualizar a minor versions.
TypeScriptAgente con allowedTools y trust check
import { query } from "@anthropic-ai/claude-agent-sdk";
// Source: https://code.claude.com/docs/en/agent-sdk/mcp#httpsse-servers
async function main() {
for await (const message of query({
prompt: `
1. Call search_products with query "laptop" limit 5
2. Call get_merchant_profile to get trust_score
3. If trust_score >= 0.70, call create_cart with the first result
4. Report the cart_id and trust_score
`,
options: {
mcpServers: {
trusteed: {
type: "http",
url: "https://trusteed.xyz/demo-store/mcp",
headers: {
"X-Agent-Api-Key": process.env.TRUSTEED_API_KEY ?? "",
},
},
},
allowedTools: [
"mcp__trusteed__search_products",
"mcp__trusteed__get_merchant_profile",
"mcp__trusteed__create_cart",
],
},
})) {
if (message.type === "result" && message.subtype === "success") {
process.stdout.write(JSON.stringify(message.result) + "\n");
}
if (message.type === "assistant") {
for (const block of message.message.content) {
if (block.type === "text") {
process.stdout.write(block.text);
}
}
}
}
}
main().catch((err) => process.stderr.write(String(err)));allowedTools limita qué herramientas MCP puede usar el agente — importante para reducir blast radius en producción.
Vercel AI SDK
Vercel AI SDK — TypeScript
Instalar
Versión probada: ai ≥ 6.0.0npm install ai @ai-sdk/openaiNota: experimental_createMCPClient aún está en beta — la API puede cambiar.
TypeScript (Node.js)generateText con cliente MCP
import { experimental_createMCPClient as createMCPClient } from "ai";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
url: "https://trusteed.xyz/demo-store/mcp",
headers: {
"X-Agent-Api-Key": process.env.TRUSTEED_API_KEY ?? "",
},
},
});
const tools = await mcpClient.tools();
const { text, toolCalls } = await generateText({
model: openai("gpt-4o"),
tools,
maxSteps: 6,
system: `You are a shopping assistant.
IMPORTANT: Always call get_merchant_profile first and verify trust_score >= 0.70.
If trust_score < 0.70, do NOT create a cart. Inform the user instead.`,
prompt: "Find me a laptop under $1500 and start the checkout process.",
});
process.stdout.write("Response: " + text + "\n");
process.stdout.write("Tool calls: " + toolCalls.length + "\n");
await mcpClient.close();
}
main().catch((err) => process.stderr.write(String(err)));TypeScript (Next.js App Router)Streaming en Next.js App Router
// app/api/shop/route.ts
import { experimental_createMCPClient as createMCPClient } from "ai";
import { streamText } from "ai";
import { openai } from "@ai-sdk/openai";
export async function POST(req: Request) {
const { message } = await req.json();
const mcpClient = await createMCPClient({
transport: {
type: "http",
url: `https://trusteed.xyz/${process.env.STORE_SLUG}/mcp`,
headers: { "X-Agent-Api-Key": process.env.TRUSTEED_API_KEY ?? "" },
},
});
const tools = await mcpClient.tools();
const result = streamText({
model: openai("gpt-4o"),
tools,
maxSteps: 8,
system: "Shopping assistant. Verify trust_score >= 0.70 before checkout.",
messages: [{ role: "user", content: message }],
onFinish: () => mcpClient.close(),
});
return result.toDataStreamResponse();
}streamText con onFinish cierra el cliente MCP automáticamente cuando la respuesta finaliza, evitando fugas de conexión.
Patrón de Trust Check — común a los 3 SDKs
Umbrales de trust_score que tu agente debe aplicar antes de iniciar checkout
| Puntuación | Nivel | Acción del agente |
|---|---|---|
| ≥ 0.95 | ELITE | Proceder sin fricción |
| ≥ 0.85 | VERIFIED | Proceder con confirmación estándar |
| ≥ 0.70 | STANDARD | Mínimo elegible para checkout |
| < 0.70 | NO PROCEDER | No iniciar checkout |
Metodología completa: GET /api/v1/trust/methodology
¿Listo para conectar? Obtén tu API key en segundos.
Obtener API Key