pinecone-assistant

--- Créez, gérez et discutez avec Pinecone Assistants pour la Q&R de documents avec citations. Gère toutes les opérations d'assistant - créer, télécharger, synchroniser, discuter, récupérer le contexte et lister. Reconnaît le langage naturel comme "créer un assistant à partir de mes documents", "interroger mon assistant sur X" ou "télécharger mes documents vers Pinecone".

npx skills add https://github.com/pinecone-io/skills --skill pinecone-assistant

Assistant Pinecone

Assistant Pinecone est un service RAG entièrement géré. Téléchargez des documents, posez des questions, obtenez des réponses avec citations. Aucun pipeline d'embedding ou infrastructure requis.

Tous les scripts sont dans scripts/ relatif à ce répertoire de compétences. Exécutez avec : uv run scripts/script_name.py [arguments]

Opérations

À faire Script Arguments clés
Créer un assistant scripts/create.py --name --instructions --region
Télécharger des fichiers scripts/upload.py --assistant --source --patterns
Synchroniser les fichiers (incrémental) scripts/sync.py --assistant --source --delete-missing --dry-run
Discuter / poser une question scripts/chat.py --assistant --message
Obtenir des extraits de contexte scripts/context.py --assistant --query --top-k
Lister les assistants scripts/list.py --files --json

Pour les détails complets du flux de travail de toute opération, lisez le fichier pertinent dans references/.

Reconnaissance du Langage Naturel

Gérez proactivement ces modèles sans nécessiter de commandes explicites :

Créer : « create an assistant », « make an assistant called X », « set up an assistant for my docs » → Voir references/create.md

Télécharger : « upload my docs », « add files to my assistant », « index my documentation » → Voir references/upload.md

Synchroniser : « sync my docs », « update my assistant », « keep assistant in sync », « refresh from ./docs » → Voir references/sync.md

Discuter : « ask my assistant about X », « what does my assistant know about X », « chat with X » → Voir references/chat.md

Contexte : « search my assistant for X », « find context about X » → Voir references/context.md

Lister : « show my assistants », « what assistants do I have » → Exécutez uv run scripts/list.py

Mémoire de Conversation

Suivez le dernier assistant utilisé au cours de la conversation :

  • Quand un utilisateur crée ou utilise pour la première fois un assistant, mémorisez son nom
  • Si l'utilisateur dit « my assistant », « it » ou « the assistant » → utilisez le dernier
  • Confirmez brièvement quel assistant vous utilisez : « Asking docs-bot... »
  • Si c'est ambigu et plusieurs existent → demandez à l'utilisateur de clarifier

Requêtes Multi-Étapes

Gérez les requêtes enchaînées naturellement. Exemple :

"Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are"

  1. uv run scripts/create.py --name docs-bot
  2. uv run scripts/upload.py --assistant docs-bot --source ./docs
  3. uv run scripts/chat.py --assistant docs-bot --message "what are the main features?"

Prérequis

  • PINECONE_API_KEY doit être disponible — terminal : export PINECONE_API_KEY="your-key", ou ajoutez à un fichier .env et exécutez les scripts avec uv run --env-file .env scripts/...
  • uv doit être installé — installer uv
  • Obtenez une clé API gratuite sur : https://app.pinecone.io/?sessionType=signup