Skip to content

Add TypeScript agent quickstart article for Azure DocumentDB#35

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/create-typescript-agent-article
Draft

Add TypeScript agent quickstart article for Azure DocumentDB#35
Copilot wants to merge 3 commits intomainfrom
copilot/create-typescript-agent-article

Conversation

Copy link
Contributor

Copilot AI commented Feb 6, 2026

Creates TypeScript agent article based on the Go agent reference, adapting the two-agent architecture (planner + synthesizer) for Node.js/LangChain ecosystem.

Files Added

  • quickstart-agent-typescript.md - Complete quickstart guide covering:

    • Prerequisites and Azure resource requirements
    • Passwordless (Azure Identity) and API key authentication
    • Project structure and code walkthrough
    • Agent implementation using LangChain's framework
    • Tool definition with Zod schema validation
    • System prompts for planner and synthesizer agents
  • typescript-agent-article-questions.md - Tracks unresolved items:

    • Missing media assets (architecture diagram, VS Code screenshot)
    • Recommendations for docs repository publication

Key Adaptations from Go Version

Aspect Go TypeScript
Framework Custom implementation LangChain agent framework
Tool Definition Manual OpenAI function calling tool() with Zod schemas
Type Validation Go structs TypeScript + Zod runtime validation
Vector Store Custom MongoDB client @langchain/azure-cosmosdb
Commands go run cmd/... npm run upload/start/cleanup

Code References

All code snippets reference ai/vector-search-agent-ts/:

  • src/agent.ts - Agent orchestration
  • src/vector-store.ts - Tool implementation
  • src/utils/prompts.ts - System prompts
  • src/utils/clients.ts - Azure client setup

Dependencies for Publication

Media assets need creation in MicrosoftDocs repository:

  • media/quickstart-agent-typescript/agent-architecture-typescript.svg
  • media/quickstart-agent-typescript/documentdb-view-data.png
Original prompt

This section details on the original issue you should resolve

<issue_title>Create the TypeScript agent article</issue_title>
<issue_description>Create the markdown file for the TypeScript agent article.

  1. Base the article on the existing Go article (https://github.com/MicrosoftDocs/azure-databases-docs/blob/main/articles/documentdb/quickstart-agent-go.md) for the agent for DocumentDB.
  2. Any information or steps that are specific to Go needs to change for TypeScript. Use the current vector search TypeScript article for an understanding of the language specific steps. https://github.com/MicrosoftDocs/azure-databases-docs/blob/main/articles/documentdb/quickstart-nodejs-vector-search.md
  3. Change the links to pull in the code files to the TS sample in this repo at ./ai/vector-search-typescript
  4. Provide a list of any questions or issues you couldn't resolve.

The output is a markdown file. </issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 2 commits February 6, 2026 19:01
Co-authored-by: diberry <41597107+diberry@users.noreply.github.com>
Co-authored-by: diberry <41597107+diberry@users.noreply.github.com>
Copilot AI changed the title [WIP] Create markdown file for TypeScript agent article Add TypeScript agent quickstart article for Azure DocumentDB Feb 6, 2026
Copilot AI requested a review from diberry February 6, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create the TypeScript agent article

2 participants

Comments