Guía paso a paso para utilizar los servicios CrewAI y Capella AI
En este tutorial, aprenderás a crear un sofisticado sistema de IA multiagente que genera contenido creativo utilizando Servicios de inteligencia artificial de Couchbase Capella para almacenar datos, generar incrustaciones utilizando modelos de incrustación e inferencia LLM. Crearemos un “Generador de guiones de Seinfeld” que muestre:
- Orquestación multiagente con CrewAI
- RAG (generación aumentada por recuperación) con búsqueda vectorial de consultas de Couchbase
- Servicio Couchbase Capella Model para alojar el modelo de incrustación y LLM.
- Servicio de vectorización de Couchbase para vectorizar datos almacenados en Couchbase.
Al final, tendrás un sistema operativo en el que varios agentes de IA especializados colaboran para generar guiones de televisión auténticos.
¿Qué son los flujos de trabajo multiagente?
Los flujos de trabajo multiagente implican la colaboración de varios agentes de IA, cada uno especializado en una tarea específica, de forma muy similar a lo que ocurre en una sala de guionistas de televisión.
Los agentes y sus funciones
| Agente | Papel | Especialidad |
| Analizador de temas | Desglosa el tema | Identifica los ángulos cómicos. |
| Arquitecto de tramas | Estructura narrativa de los diseños | Crea subforos A/B/C. |
| Experto en voces de personajes | Garantiza la autenticidad. | Coincide con el discurso del personaje |
| Guionista de diálogos | Escribe escenas. | Diálogo + acotaciones escénicas |
| Revisor de calidad | Editor final | Garantiza la coherencia. |
¿Por qué los servicios de IA de Couchbase Capella?
Los servicios de inteligencia artificial de Couchbase Capella ofrecen:
- Plataforma unificada: base de datos + vectorización + búsqueda + modelos
- Vectorización para la incrustación de documentos
- API de incrustaciones
- Inferencia LLM
- Búsqueda vectorial para coincidencias semánticas
Configuración de los servicios de Couchbase Capella
Crear un clúster en Couchbase Capella
- Entrar en Couchbase Capella.
- Cree un nuevo clúster o utilice uno existente. Tenga en cuenta que el clúster debe ejecutar la última versión de Couchbase Server (8.0) con los servicios de datos, consultas, índices y eventos.
- Crear un bucket (por ejemplo, Seinfeld)
- Crear un ámbito (por ejemplo, episodios) y recolección (por ejemplo, guiones) para sus datos
Habilitar servicios de IA
- Navega hasta la sección Servicios de IA de Capella en la interfaz de usuario.
- Implementar los modelos de incrustación y LLM
- Para esta demostración, debe iniciar una integración y un LLM en la misma región que el clúster Capella donde se almacenarán los datos.
- Para que esta demostración funcione correctamente, es necesario implementar un modelo de lenguaje grande (LLM) que tenga capacidades de llamada a herramientas, como mistralai/mistral-7b-instruct-v0.3. Para las incrustaciones, puede elegir un modelo como el nvidia/llama-3.2-nv-embedqa-1b-v2.
- Anote la URL del punto final y genere claves API.
Para obtener más detalles sobre el lanzamiento de modelos de IA, puede consultar el documentación oficial.
Cargue sus datos
Para este tutorial, estamos usando el conjunto de datos público que contiene todos los diálogos de Seinfeld de Kaggle. Podemos importar esto a nuestro clúster Couchbase Capella utilizando cualquiera de los modos de importación como cbimport o la interfaz de usuario.
Tus documentos deben tener la siguiente estructura:
|
1 2 3 4 5 6 7 |
json { "Character": "JERRY", "Dialogue": "What's the deal with airline peanuts?", "Season": 3, "EpisodeNo": 15, } |
Vectorización y creación de índices de búsqueda vectorial
Podemos utilizar el servicio de vectorización para datos estructurados con el fin de vectorizar los diálogos almacenados en la colección Couchbase.
En este caso, como nuestros datos ya están en un formato estructurado dentro del clúster de Couchbase, podemos utilizar el Vectorizar a partir de datos estructurados: flujo de trabajo.
Necesitamos integrar el Diálogo campo en un nuevo campo, diálogo_incrustación.
Durante el flujo de trabajo de vectorización, también podemos crear el altamente eficiente Índice vectorial a hiperescala para la búsqueda vectorial con buenos valores predeterminados.
Una vez completado el flujo de trabajo, veremos un campo adicional en todos los documentos que contengan el diálogo_incrustación campo.
Creación del agente
Creamos múltiples agentes utilizando CrewAI para coordinar a los agentes. Cada agente tiene una función específica relacionada con la tarea general de generar el script. Los agentes se comunican entre sí utilizando el contexto compartido para alcanzar el objetivo general.
El código para el agente se puede encontrar en este Repositorio de GitHub como referencia.
Conceptos clave
RAG (Generación Aumentada de Recuperación)
RAG mejora los resultados del LLM al proporcionar contexto relevante a partir de una base de datos. En este caso, proporcionamos diálogos similares a la entrada proporcionada por el usuario.
Colaboración entre agentes
Los agentes transmiten información a través del contexto de la tarea:
Integración de los servicios del modelo Capella AI
Couchbase Capella AI Services proporciona puntos finales compatibles con OpenAI que utilizan los agentes. Para las incrustaciones, utilizamos el paquete LangChain OpenAI, ya que se utiliza en asociación con el Integración de LangChain con Couchbase. Para el LLM, estamos utilizando el modelo Capella a través de LiteLLM en CrewAI.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
python # Embeddings from langchain_openai import OpenAIEmbeddings embeddings = OpenAIEmbeddings( openai_api_key=CAPELLA_EMBEDDING_KEY, openai_api_base=CAPELLA_ENDPOINT, model=EMBEDDING_MODEL_NAME, ) # LLM from crewai import LLM llm = LLM( model=LLM_NAME, api_key=CAPELLA_LLM_KEY, base_url=CAPELLA_ENDPOINT, ) |
Probándolo
Entrada: Jerry compra un altavoz inteligente que lo malinterpreta todo.
Salida:
Episodio de Seinfeld #: Jerry compra un altavoz inteligente que lo malinterpreta todo.
**Título:** El altavoz inteligente
—
### Apertura en frío – INT. APARTAMENTO DE JERRY
*(Jerry está junto a su nuevo altavoz inteligente sobre la encimera, tratando de mantener la paciencia).*
**JERRY:**
Toca “Take Five” de Dave Brubeck.
**PONENTE:**
Pido cinco latas de descafeinado.
*(Jerry parpadea, impasible).*
**JERRY:**
Bueno, al menos se ha reconocido mi adicción a la cafeína.
*(Kramer irrumpe en la habitación con los ojos desorbitados y agitando los brazos).*
**KRAMER:**
¡Jerry! ¡Tienes que conseguir uno de estos! ¡Es el futuro, amigo!
*(Elaine entra con los brazos cruzados y el ceño fruncido).*
**ELAINE:**
Me acaba de llamar “Helen”. ¡Helen! ¿Quién es Helen?
*(George llama frenéticamente desde la habitación de al lado).*
**GEORGE (fuera de cámara):**
Jerry, ¡creo que me está espiando!
*(Jerry se encoge de hombros).*
**JERRY:**
Genial, ahora la tostadora se está tomando partido.
*(Se gira hacia la cámara.)*
**JERRY:**
Para ser alguien a quien llaman “inteligente”, este es el compañero de cuarto más tonto que he tenido nunca.
—
### Escena 2 – INT. APARTAMENTO DE JERRY
*(Jerry sostiene su teléfono, cada vez más molesto. El interlocutor se sienta inocentemente).*
**JERRY:**
Configurar recordatorio: comprar leche.
**PONENTE:**
Tocando “No llores por mí, Argentina”.”
**JERRY:**
Eso no es un recordatorio. Es una traición musical.
*(Elaine irrumpe en la habitación con mirada furiosa).*
**ELAINE:**
Me volvió a llamar Helen. ¡Helen! ¿Quién es Helen?
**JERRY:**
Quizás esté tratando de darte una nueva identidad.
**ELAINE:** *(sarcástica)*
Maravilloso. Un programa de protección de testigos a través de la electrónica.
*(Kramer entra con orgullo, sosteniendo un artilugio conectado al altavoz).*
**KRAMER:**
¡Relájate! ¡La actualización de Kramer! ¡Predice lo que quieres antes de que tú mismo lo sepas!
**JERRY:** *(escéptico)*
La última vez que arreglaste algo, terminé con un espectáculo de fuentes en mi sala.
**KRAMER:**
¡Hola, arte!
—
### Escena 3 – INT. OFICINA DE GEORGE
*(George camina nerviosamente, susurrando por teléfono).*
**GEORGE:**
¡Es espionaje, Jerry! ¡Encontré grabaciones... conversaciones conspirando contra mí!
*(Reproduce un clip distorsionado).*
**GEORGE:**
¡Prueba!
*(Un compañero de trabajo pasa por delante y sonríe burlonamente).*
**COMPAÑERO DE TRABAJO:**
¿Otra vez hablando con tu teléfono? Tranquilo, George.
**GEORGE:**
¡Quieren silencio! ¡Eso es lo que quieren!
—
### Escena 4 – INT. OFICINA DE ELAINE
*(Elaine en videollamada; el locutor pronuncia mal).*
**PONENTE:**
Reproduciendo el audiolibro “Helena de Troya”.
**ELAINE:** *(gritando)*
¡No! ¡Helen no! ¡Elaine!
*(Un compañero de trabajo susurra fuera de cámara).*
**COMPAÑERO DE TRABAJO:**
¿Su teléfono está embrujado o qué?
—
### Escena 5 – INT. APARTAMENTO DE JERRY – NOCHE
*(Jerry está en una cita; de repente, se oyen ruidos de cabra a todo volumen por el altavoz).*
**LA CITA DE JERRY:**
¿Qué fue eso?
**JERRY:**
Mi altavoz inteligente... menos inteligente que yo.
*(Elaine oye a alguien gritar “Helen” cerca de ella y cruza los brazos).*
**ELAINE:**
Helen vuelve a atacar.
*(Jerry y Elaine intercambian una mirada).*
—
### Escena 6 – INT. APARTAMENTO DE JERRY
*(Kramer presenta el altavoz modificado).*
**KRAMER:**
¡Confía en mí! ¡Este bebé anticipa lo que quieres!
*(Presiona el botón; el altavoz emite balidos de cabra, anuncios aleatorios; las luces parpadean).*
**JERRY:**
Genial. Es un club de jazz embrujado.
*(Elaine le grita al dispositivo; George entra furioso.)*
**GEORGE:**
¡Kramer! ¡Tú estás involucrado! ¡Esto es sabotaje!
**KRAMER:**
¡No, solo un poco de caos para la creatividad!
*(El altavoz reproduce la cinta de la conspiración de George a todo volumen).*
**GEORGE:**
¡No! ¡La cinta no!
*(Se apagan las luces; silencio).*
—
### Final – INT. CAFÉ DEL MONJE
*(El grupo se sienta, agotado).*
**JERRY:**
Para ser alguien a quien llaman “inteligente”, este es el compañero de cuarto más tonto que he tenido nunca.
**ELAINE:**
Todavía me llama Helen. ¡Helen! ¡No conozco a ninguna Helen!
**GEORGE:**
Perdí mi trabajo, mi cita. Si vuelve a escuchar una vez más, me voy.
**KRAMER:** *(sonriendo)*
Estoy trabajando en la próxima versión. ¡Va a ser revolucionaria!
**JERRY:** *(a la cámara, con tono seco)*
Las revoluciones nunca pasan desapercibidas.
—
### Etiqueta: INT. APARTAMENTO DE JERRY – NOCHE
*(Jerry desconecta el altavoz y suspira).*
**PONENTE:**
(estático) Adiós, Jerry.
*(Jerry mira a la cámara).*
**JERRY:**
Incluso los tontos se despiden.
*(Fundido de salida)*.
—
**Calificación de calidad:** 9/10
**Notas:**
– Las voces de los personajes suenan auténticas: el humor sarcástico y seco de Jerry captura a la perfección el humor observacional de Seinfeld sobre los fallos tecnológicos. La neurosis paranoica de George se intensifica de forma clásica. La indignación de Elaine por los nombres equivocados es acertada y divertidamente personal. El entusiasmo desenfrenado de Kramer contrarresta eficazmente el caos.
– Las tramas se entrelazan con claridad y se resuelven con una escalada de malentendidos que culminan en el fiasco de la “mejora” de Kramer.
– Las respuestas (“¡Helen!”, “¡Es espionaje!”, la solución “revolucionaria” de Kramer) son oportunas y suenan naturales.
El humor es observacional, basado en frustraciones tecnológicas muy modernas pero mundanas, evitando el humor físico o los chistes demasiado generales.
– El ritmo de las escenas es ágil, con una duración normal que refleja el ritmo clásico de las comedias de situación; las acotaciones escénicas marcan el tiempo y los ritmos de reacción para maximizar los efectos cómicos.
– Diálogos pulidos gradualmente para lograr chistes más impactantes y claridad, conservando el ritmo y el tempo clásicos de Seinfeld.
– El remate final y la escena final reflejan eficazmente el habitual comentario meta final de Seinfeld.
Este episodio encajaría perfectamente en la serie original, mostrando la respuesta neurótica de cada personaje ante una simple molestia moderna que se exagera de forma hilarante.
Resumen
En este tutorial, has aprendido a:
- Cree un sistema de IA multiagente con CrewAI.
- Vectorizar datos utilizando los flujos de trabajo de vectorización de Couchbase
- Utilice los servicios de inteligencia artificial de Couchbase Capella para incrustaciones y LLM.
- Implementar RAG con Couchbase Vector Search (índice a hiperescala)
La combinación de la plataforma de datos unificada de Couchbase con el marco multiagente de CrewAI da lugar a potentes aplicaciones de inteligencia artificial capaces de generar contenido de alta calidad y sensible al contexto.
