> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurora-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinecone

> Usa la base de datos vectorial Pinecone

export const BlockInfoCard = ({type, color, icon = false, iconSvg}) => {
  return <div className="mb-6 overflow-hidden rounded-lg border border-border">
      <div className="flex items-center justify-center p-6">
        <div className="flex h-20 w-20 items-center justify-center rounded-lg" style={{
    backgroundColor: color
  }}>
          {iconSvg ? <div className="h-10 w-10 text-white" dangerouslySetInnerHTML={{
    __html: iconSvg
  }} /> : <div className="font-mono text-xl opacity-70">
              {type.substring(0, 2)}
            </div>}
        </div>
      </div>
      {icon && <style jsx global>{`
          .block-icon {
            width: 80px;
            height: 80px;
            margin: 1rem auto;
            display: block;
          }
        `}</style>}
    </div>;
};

<BlockInfoCard
  type="pinecone"
  color="#0D1117"
  icon={true}
  iconSvg={`<svg className="block-icon"
  
  
  
  viewBox='0 0 256 288'
  version='1.1'
  xmlns='http://www.w3.org/2000/svg'
  xmlnsXlink='http://www.w3.org/1999/xlink'
  preserveAspectRatio='xMidYMid'
>
  <path
    d='M108.633615,254.43629 C117.713862,254.43629 125.074857,261.797284 125.074857,270.877532 C125.074857,279.957779 117.713862,287.318774 108.633615,287.318774 C99.5533677,287.318774 92.1923728,279.957779 92.1923728,270.877532 C92.1923728,261.797284 99.5533677,254.43629 108.633615,254.43629 Z M199.849665,224.438339 L216.09705,229.252379 L203.199913,272.780219 C202.072982,276.58361 198.458049,279.095992 194.500389,278.826397 L190.516677,278.552973 L190.419263,278.633409 L149.02918,275.728903 L150.180842,258.822508 L177.989056,260.709686 L159.783784,234.447622 L173.709616,224.792379 L191.938895,251.08702 L199.849665,224.438339 Z M23.0126771,194.347476 L39.9158866,195.544979 L37.935897,223.348728 L64.1501315,205.120082 L73.8271476,219.030793 L47.578736,237.278394 L74.3707554,245.173037 L69.5818063,261.427835 L25.8485266,248.543243 C22.0304448,247.418369 19.5101155,243.787479 19.7913963,239.817092 L23.0126771,194.347476 Z M132.151306,170.671396 L162.658679,207.503468 L148.909247,218.891886 L130.753266,196.972134 L124.866941,230.673893 L107.280249,227.599613 L113.172232,193.845272 L88.7296311,208.256891 L79.6674587,192.874434 L120.745504,168.674377 C124.522104,166.449492 129.355297,167.295726 132.151306,170.671396 Z M217.504528,145.960198 L232.744017,137.668804 L254.94482,178.473633 C256.889641,182.048192 256.088221,186.494171 253.017682,189.164674 L249.876622,191.878375 L217.826246,219.77131 L206.441034,206.680621 L227.988588,187.934494 L195.893546,182.152609 L198.972402,165.078949 L231.044844,170.857793 L217.504528,145.960198 Z M37.7821805,103.299272 L49.2622123,116.306888 L28.0106317,135.050179 L60.1668233,140.664193 L57.1863573,157.755303 L24.9947229,152.136967 L38.822104,177.134576 L23.6411026,185.532577 L1.08439616,144.756992 C-0.885025494,141.196884 -0.115545265,136.746375 2.93488097,134.054184 L37.7821805,103.299272 Z M146.476311,89.8796828 L176.88045,126.612847 L163.1271,137.996532 L144.975445,116.067101 L139.08912,149.778947 L121.502428,146.704666 L127.374238,113.081452 L103.025237,127.354817 L93.9976317,111.952048 L131.398812,90.0233663 L131.435631,89.880899 L131.600545,89.9023265 L135.085833,87.870141 C138.861877,85.6569913 143.68556,86.5079996 146.476311,89.8796828 Z M185.655786,71.8143168 L192.305535,55.7902703 L235.318239,73.6399229 C239.072486,75.1978811 241.2415,79.1537636 240.536356,83.1568091 L239.820231,87.1385839 L232.47517,128.919545 L215.389188,125.909819 L220.312646,97.9413879 L191.776157,113.7129 L183.390302,98.5251862 L211.981072,82.7408038 L185.655786,71.8143168 Z M103.71696,40.2373824 L104.456513,57.5706533 L76.0432671,58.785006 L97.4730368,83.2749086 L84.4165529,94.6993319 L62.9507932,70.1728358 L57.949673,98.1737132 L40.8716575,95.1191088 L49.0561498,49.3603563 C49.771444,45.3612115 53.1664633,42.3942036 57.2253811,42.2210231 L61.246149,42.0411642 L61.3363168,41.9758 L103.71696,40.2373824 Z M161.838155,3.27194826 L192.104824,40.2369789 L178.291207,51.5474574 L160.327329,29.6043227 L154.268381,63.2715157 L136.697231,60.1096121 L142.766468,26.3665075 L118.24002,40.7062765 L109.232678,25.2916494 L150.427675,1.21987397 C154.218286,-0.995121237 159.056796,-0.124957814 161.838155,3.27194826 Z'
    fill='currentColor'
  />
</svg>`}
/>

[Pinecone](https://www.pinecone.io) es una base de datos vectorial diseñada para crear aplicaciones de búsqueda vectorial de alto rendimiento. Permite el almacenamiento eficiente, la gestión y la búsqueda por similitud de embeddings vectoriales de alta dimensionalidad, lo que la hace ideal para aplicaciones de IA que requieren capacidades de búsqueda semántica.

Con Pinecone, puedes:

* **Almacenar embeddings vectoriales**: Gestionar eficientemente vectores de alta dimensionalidad a escala
* **Realizar búsquedas por similitud**: Encontrar los vectores más similares a un vector de consulta en milisegundos
* **Construir búsquedas semánticas**: Crear experiencias de búsqueda basadas en significado en lugar de palabras clave
* **Implementar sistemas de recomendación**: Generar recomendaciones personalizadas basadas en similitud de contenido
* **Desplegar modelos de aprendizaje automático**: Operacionalizar modelos de ML que dependen de la similitud vectorial
* **Escalar sin problemas**: Manejar miles de millones de vectores con rendimiento consistente
* **Mantener índices en tiempo real**: Actualizar tu base de datos vectorial en tiempo real a medida que llegan nuevos datos

En Sim, la integración con Pinecone permite a tus agentes aprovechar las capacidades de búsqueda vectorial de forma programática como parte de sus flujos de trabajo. Esto permite escenarios de automatización sofisticados que combinan el procesamiento del lenguaje natural con la búsqueda y recuperación semántica. Tus agentes pueden generar embeddings a partir de texto, almacenar estos vectores en índices de Pinecone y realizar búsquedas de similitud para encontrar la información más relevante. Esta integración cierra la brecha entre tus flujos de trabajo de IA y la infraestructura de búsqueda vectorial, permitiendo una recuperación de información más inteligente basada en el significado semántico en lugar de la coincidencia exacta de palabras clave. Al conectar Aurora Workflow\.con Pinecone, puedes crear agentes que entienden el contexto, recuperan información relevante de grandes conjuntos de datos y ofrecen respuestas más precisas y personalizadas a los usuarios, todo sin requerir una gestión compleja de infraestructura o conocimientos especializados de bases de datos vectoriales.

## Instrucciones de uso

Integra Pinecone en el flujo de trabajo. Puede generar embeddings, insertar texto, buscar con texto, obtener vectores y buscar con vectores. Requiere clave API.

## Herramientas

### `pinecone_generate_embeddings`

Generar embeddings a partir de texto usando Pinecone

#### Entrada

| Parámetro | Tipo   | Obligatorio | Descripción                                        |
| --------- | ------ | ----------- | -------------------------------------------------- |
| `model`   | string | Sí          | Modelo a utilizar para generar embeddings          |
| `inputs`  | array  | Sí          | Array de entradas de texto para generar embeddings |
| `apiKey`  | string | Sí          | Clave API de Pinecone                              |

#### Salida

| Parámetro     | Tipo   | Descripción                                                |
| ------------- | ------ | ---------------------------------------------------------- |
| `data`        | array  | Datos de embeddings generados con valores y tipo de vector |
| `model`       | string | Modelo utilizado para generar embeddings                   |
| `vector_type` | string | Tipo de vector generado (denso/disperso)                   |
| `usage`       | object | Estadísticas de uso para la generación de embeddings       |

### `pinecone_upsert_text`

Insertar o actualizar registros de texto en un índice de Pinecone

#### Entrada

| Parámetro   | Tipo   | Obligatorio | Descripción                                                                                           |
| ----------- | ------ | ----------- | ----------------------------------------------------------------------------------------------------- |
| `indexHost` | string | Sí          | URL completa del host del índice de Pinecone                                                          |
| `namespace` | string | Sí          | Espacio de nombres donde insertar los registros                                                       |
| `records`   | array  | Sí          | Registro o matriz de registros para insertar, cada uno conteniendo \_id, texto y metadatos opcionales |
| `apiKey`    | string | Sí          | Clave API de Pinecone                                                                                 |

#### Salida

| Parámetro       | Tipo   | Descripción                                  |
| --------------- | ------ | -------------------------------------------- |
| `statusText`    | string | Estado de la operación de inserción          |
| `upsertedCount` | number | Número de registros insertados correctamente |

### `pinecone_search_text`

Buscar texto similar en un índice de Pinecone

#### Entrada

| Parámetro     | Tipo   | Obligatorio | Descripción                                  |
| ------------- | ------ | ----------- | -------------------------------------------- |
| `indexHost`   | string | Sí          | URL completa del host del índice de Pinecone |
| `namespace`   | string | No          | Espacio de nombres donde buscar              |
| `searchQuery` | string | Sí          | Texto a buscar                               |
| `topK`        | string | No          | Número de resultados a devolver              |
| `fields`      | array  | No          | Campos a devolver en los resultados          |
| `filter`      | object | No          | Filtro a aplicar a la búsqueda               |
| `rerank`      | object | No          | Parámetros de reordenación                   |
| `apiKey`      | string | Sí          | Clave API de Pinecone                        |

#### Salida

| Parámetro | Tipo  | Descripción                                           |
| --------- | ----- | ----------------------------------------------------- |
| `matches` | array | Resultados de búsqueda con ID, puntuación y metadatos |

### `pinecone_search_vector`

Buscar vectores similares en un índice de Pinecone

#### Entrada

| Parámetro         | Tipo    | Obligatorio | Descripción                                  |
| ----------------- | ------- | ----------- | -------------------------------------------- |
| `indexHost`       | string  | Sí          | URL completa del host del índice de Pinecone |
| `namespace`       | string  | No          | Espacio de nombres donde buscar              |
| `vector`          | array   | Sí          | Vector a buscar                              |
| `topK`            | number  | No          | Número de resultados a devolver              |
| `filter`          | object  | No          | Filtro a aplicar a la búsqueda               |
| `includeValues`   | boolean | No          | Incluir valores de vector en la respuesta    |
| `includeMetadata` | boolean | No          | Incluir metadatos en la respuesta            |
| `apiKey`          | string  | Sí          | Clave API de Pinecone                        |

#### Salida

| Parámetro   | Tipo   | Descripción                                                                |
| ----------- | ------ | -------------------------------------------------------------------------- |
| `matches`   | array  | Resultados de búsqueda de vectores con ID, puntuación, valores y metadatos |
| `namespace` | string | Espacio de nombres donde se realizó la búsqueda                            |

### `pinecone_fetch`

Obtener vectores por ID desde un índice de Pinecone

#### Entrada

| Parámetro   | Tipo   | Obligatorio | Descripción                                         |
| ----------- | ------ | ----------- | --------------------------------------------------- |
| `indexHost` | string | Sí          | URL completa del host del índice de Pinecone        |
| `ids`       | array  | Sí          | Array de IDs de vectores a obtener                  |
| `namespace` | string | No          | Espacio de nombres desde donde obtener los vectores |
| `apiKey`    | string | Sí          | Clave API de Pinecone                               |

#### Salida

| Parámetro | Tipo  | Descripción                                                |
| --------- | ----- | ---------------------------------------------------------- |
| `matches` | array | Vectores obtenidos con ID, valores, metadatos y puntuación |

## Notas

* Categoría: `tools`
* Tipo: `pinecone`
