AI SDKs
Integración de verificación de correos con AI SDKs. Guías para Anthropic, OpenAI, LangChain y Vercel AI SDK.
Construya aplicaciones de IA con capacidades integradas de verificación de correo electrónico usando frameworks y SDKs de IA populares.
Frameworks compatibles
Vercel AI SDK
Llamada de herramientas con aplicaciones Next.js y React
LangChain
Herramientas personalizadas para agentes LangChain en Python y JavaScript
Llamada de funciones de OpenAI
Llamada de funciones nativa con modelos GPT de OpenAI
Uso de herramientas de Anthropic
Uso de herramientas con modelos Claude
Comparación
| Framework | Lenguaje | Mejor para | Complejidad |
|---|---|---|---|
| Vercel AI SDK | TypeScript | Aplicaciones Next.js, streaming | Baja |
| LangChain | Python/JS | Agentes complejos, cadenas | Media |
| OpenAI Functions | Cualquiera | Integración directa con GPT | Media |
| Anthropic Tools | Cualquiera | Integración directa con Claude | Media |
Ejemplo rápido
Aquí hay una definición de herramienta simple que funciona en todos los frameworks:
const verifyEmailTool = {
name: 'verify_email',
description: 'Verify if an email address is valid and deliverable',
parameters: {
type: 'object',
properties: {
email: {
type: 'string',
description: 'The email address to verify',
},
},
required: ['email'],
},
execute: async ({ email }) => {
const response = await fetch('https://api.billionverify.com/v1/verify/single', {
method: 'POST',
headers: {
'BV-API-KEY': process.env.BV_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email }),
});
return response.json();
},
};Mejores prácticas
1. Manejo de errores
Siempre maneje los errores de API con gracia en sus herramientas:
execute: async ({ email }) => {
try {
const response = await fetch('https://api.billionverify.com/v1/verify/single', {
method: 'POST',
headers: {
'BV-API-KEY': process.env.BV_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email }),
});
if (!response.ok) {
if (response.status === 429) {
return { error: 'Rate limit exceeded. Please try again later.' };
}
return { error: \`Verification failed: \${response.statusText}\` };
}
return response.json();
} catch (error) {
return { error: 'Network error. Could not reach verification service.' };
}
}2. Descripciones claras de herramientas
Escriba definiciones descriptivas de herramientas para que la IA sepa cuándo usarlas:
description: \`Verify if an email address is valid and deliverable.
Returns:
- status: "valid", "invalid", or "unknown"
- deliverable: whether the email can receive messages
- disposable: whether it's a temporary email service
- role: whether it's a role-based address like info@ or support@
- score: confidence score from 0 to 1
Use this tool when:
- User asks to verify an email
- Checking if an email is real
- Validating contact information\`3. Agrupar para eficiencia
Al verificar múltiples correos electrónicos, use el endpoint bulk:
const verifyEmailsBulkTool = {
name: 'verify_emails_bulk',
description: 'Verify multiple emails at once. More efficient than verifying one by one.',
parameters: {
type: 'object',
properties: {
emails: {
type: 'array',
items: { type: 'string' },
maxItems: 100,
},
},
required: ['emails'],
},
};4. Almacenar en caché los resultados
Considere almacenar en caché los resultados de verificación para ahorrar créditos:
const cache = new Map<string, { result: any; timestamp: number }>();
const CACHE_TTL = 3600000; // 1 hour
async function verifyWithCache(email: string) {
const cached = cache.get(email);
if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
return cached.result;
}
const result = await verifyEmail(email);
cache.set(email, { result, timestamp: Date.now() });
return result;
}